<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkEntry: GTK+ 3 Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
<link rel="up" href="NumericEntry.html" title="Numeric and Text Data Entry">
<link rel="prev" href="NumericEntry.html" title="Numeric and Text Data Entry">
<link rel="next" href="GtkEntryBuffer.html" title="GtkEntryBuffer">
<meta name="generator" content="GTK-Doc V1.33.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
                  <a href="#GtkEntry.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
                  <a href="#GtkEntry.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces">  <span class="dim">|</span> 
                  <a href="#GtkEntry.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties">  <span class="dim">|</span> 
                  <a href="#GtkEntry.properties" class="shortcut">Properties</a></span><span id="nav_style_properties">  <span class="dim">|</span> 
                  <a href="#GtkEntry.style-properties" class="shortcut">Style Properties</a></span><span id="nav_signals">  <span class="dim">|</span> 
                  <a href="#GtkEntry.signals" class="shortcut">Signals</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="NumericEntry.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="NumericEntry.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="GtkEntryBuffer.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="GtkEntry"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GtkEntry.top_of_page"></a>GtkEntry</span></h2>
<p>GtkEntry — A single line text entry field</p>
</td>
<td class="gallery_image" valign="top" align="right"><img src="entry.png"></td>
</tr></table></div>
<div class="refsect1">
<a name="GtkEntry.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_proto_type">
<col class="functions_proto_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-new" title="gtk_entry_new ()">gtk_entry_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-new-with-buffer" title="gtk_entry_new_with_buffer ()">gtk_entry_new_with_buffer</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="returnvalue">GtkEntryBuffer</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-buffer" title="gtk_entry_get_buffer ()">gtk_entry_get_buffer</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-buffer" title="gtk_entry_set_buffer ()">gtk_entry_set_buffer</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-text" title="gtk_entry_set_text ()">gtk_entry_set_text</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-text" title="gtk_entry_get_text ()">gtk_entry_get_text</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">guint16</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-text-length" title="gtk_entry_get_text_length ()">gtk_entry_get_text_length</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-text-area" title="gtk_entry_get_text_area ()">gtk_entry_get_text_area</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-visibility" title="gtk_entry_set_visibility ()">gtk_entry_set_visibility</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-invisible-char" title="gtk_entry_set_invisible_char ()">gtk_entry_set_invisible_char</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-unset-invisible-char" title="gtk_entry_unset_invisible_char ()">gtk_entry_unset_invisible_char</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-max-length" title="gtk_entry_set_max_length ()">gtk_entry_set_max_length</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-activates-default" title="gtk_entry_get_activates_default ()">gtk_entry_get_activates_default</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-has-frame" title="gtk_entry_get_has_frame ()">gtk_entry_get_has_frame</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="returnvalue">GtkBorder</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-inner-border" title="gtk_entry_get_inner_border ()">gtk_entry_get_inner_border</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-width-chars" title="gtk_entry_get_width_chars ()">gtk_entry_get_width_chars</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-max-width-chars" title="gtk_entry_get_max_width_chars ()">gtk_entry_get_max_width_chars</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-activates-default" title="gtk_entry_set_activates_default ()">gtk_entry_set_activates_default</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-has-frame" title="gtk_entry_set_has_frame ()">gtk_entry_set_has_frame</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-inner-border" title="gtk_entry_set_inner_border ()">gtk_entry_set_inner_border</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-width-chars" title="gtk_entry_set_width_chars ()">gtk_entry_set_width_chars</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-max-width-chars" title="gtk_entry_set_max_width_chars ()">gtk_entry_set_max_width_chars</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gunichar</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-invisible-char" title="gtk_entry_get_invisible_char ()">gtk_entry_get_invisible_char</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-alignment" title="gtk_entry_set_alignment ()">gtk_entry_set_alignment</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gfloat</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-alignment" title="gtk_entry_get_alignment ()">gtk_entry_get_alignment</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-placeholder-text" title="gtk_entry_set_placeholder_text ()">gtk_entry_set_placeholder_text</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-placeholder-text" title="gtk_entry_get_placeholder_text ()">gtk_entry_get_placeholder_text</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-overwrite-mode" title="gtk_entry_set_overwrite_mode ()">gtk_entry_set_overwrite_mode</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-overwrite-mode" title="gtk_entry_get_overwrite_mode ()">gtk_entry_get_overwrite_mode</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">PangoLayout</span> *
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-layout" title="gtk_entry_get_layout ()">gtk_entry_get_layout</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-layout-offsets" title="gtk_entry_get_layout_offsets ()">gtk_entry_get_layout_offsets</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-layout-index-to-text-index" title="gtk_entry_layout_index_to_text_index ()">gtk_entry_layout_index_to_text_index</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-text-index-to-layout-index" title="gtk_entry_text_index_to_layout_index ()">gtk_entry_text_index_to_layout_index</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-attributes" title="gtk_entry_set_attributes ()">gtk_entry_set_attributes</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">PangoAttrList</span> *
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-attributes" title="gtk_entry_get_attributes ()">gtk_entry_get_attributes</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-max-length" title="gtk_entry_get_max_length ()">gtk_entry_get_max_length</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-visibility" title="gtk_entry_get_visibility ()">gtk_entry_get_visibility</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-completion" title="gtk_entry_set_completion ()">gtk_entry_set_completion</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion"><span class="returnvalue">GtkEntryCompletion</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-completion" title="gtk_entry_get_completion ()">gtk_entry_get_completion</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-cursor-hadjustment" title="gtk_entry_set_cursor_hadjustment ()">gtk_entry_set_cursor_hadjustment</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="returnvalue">GtkAdjustment</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-cursor-hadjustment" title="gtk_entry_get_cursor_hadjustment ()">gtk_entry_get_cursor_hadjustment</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-progress-fraction" title="gtk_entry_set_progress_fraction ()">gtk_entry_set_progress_fraction</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gdouble</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-progress-fraction" title="gtk_entry_get_progress_fraction ()">gtk_entry_get_progress_fraction</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-progress-pulse-step" title="gtk_entry_set_progress_pulse_step ()">gtk_entry_set_progress_pulse_step</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gdouble</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-progress-pulse-step" title="gtk_entry_get_progress_pulse_step ()">gtk_entry_get_progress_pulse_step</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-progress-pulse" title="gtk_entry_progress_pulse ()">gtk_entry_progress_pulse</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-im-context-filter-keypress" title="gtk_entry_im_context_filter_keypress ()">gtk_entry_im_context_filter_keypress</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-reset-im-context" title="gtk_entry_reset_im_context ()">gtk_entry_reset_im_context</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">PangoTabArray</span> *
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-tabs" title="gtk_entry_get_tabs ()">gtk_entry_get_tabs</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-tabs" title="gtk_entry_set_tabs ()">gtk_entry_set_tabs</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-icon-from-pixbuf" title="gtk_entry_set_icon_from_pixbuf ()">gtk_entry_set_icon_from_pixbuf</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-icon-from-stock" title="gtk_entry_set_icon_from_stock ()">gtk_entry_set_icon_from_stock</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-icon-from-icon-name" title="gtk_entry_set_icon_from_icon_name ()">gtk_entry_set_icon_from_icon_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-icon-from-gicon" title="gtk_entry_set_icon_from_gicon ()">gtk_entry_set_icon_from_gicon</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkImage.html#GtkImageType" title="enum GtkImageType"><span class="returnvalue">GtkImageType</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-icon-storage-type" title="gtk_entry_get_icon_storage_type ()">gtk_entry_get_icon_storage_type</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkPixbuf</span> *
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-icon-pixbuf" title="gtk_entry_get_icon_pixbuf ()">gtk_entry_get_icon_pixbuf</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-icon-stock" title="gtk_entry_get_icon_stock ()">gtk_entry_get_icon_stock</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-icon-name" title="gtk_entry_get_icon_name ()">gtk_entry_get_icon_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GIcon</span> *
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-icon-gicon" title="gtk_entry_get_icon_gicon ()">gtk_entry_get_icon_gicon</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-icon-activatable" title="gtk_entry_set_icon_activatable ()">gtk_entry_set_icon_activatable</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-icon-activatable" title="gtk_entry_get_icon_activatable ()">gtk_entry_get_icon_activatable</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-icon-sensitive" title="gtk_entry_set_icon_sensitive ()">gtk_entry_set_icon_sensitive</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-icon-sensitive" title="gtk_entry_get_icon_sensitive ()">gtk_entry_get_icon_sensitive</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-icon-at-pos" title="gtk_entry_get_icon_at_pos ()">gtk_entry_get_icon_at_pos</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-icon-tooltip-text" title="gtk_entry_set_icon_tooltip_text ()">gtk_entry_set_icon_tooltip_text</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-icon-tooltip-text" title="gtk_entry_get_icon_tooltip_text ()">gtk_entry_get_icon_tooltip_text</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-icon-tooltip-markup" title="gtk_entry_set_icon_tooltip_markup ()">gtk_entry_set_icon_tooltip_markup</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-icon-tooltip-markup" title="gtk_entry_get_icon_tooltip_markup ()">gtk_entry_get_icon_tooltip_markup</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-icon-drag-source" title="gtk_entry_set_icon_drag_source ()">gtk_entry_set_icon_drag_source</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-current-icon-drag-source" title="gtk_entry_get_current_icon_drag_source ()">gtk_entry_get_current_icon_drag_source</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-icon-area" title="gtk_entry_get_icon_area ()">gtk_entry_get_icon_area</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-input-purpose" title="gtk_entry_set_input_purpose ()">gtk_entry_set_input_purpose</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkEntry.html#GtkInputPurpose" title="enum GtkInputPurpose"><span class="returnvalue">GtkInputPurpose</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-input-purpose" title="gtk_entry_get_input_purpose ()">gtk_entry_get_input_purpose</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-set-input-hints" title="gtk_entry_set_input_hints ()">gtk_entry_set_input_hints</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkEntry.html#GtkInputHints" title="enum GtkInputHints"><span class="returnvalue">GtkInputHints</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-get-input-hints" title="gtk_entry_get_input_hints ()">gtk_entry_get_input_hints</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkEntry.html#gtk-entry-grab-focus-without-selecting" title="gtk_entry_grab_focus_without_selecting ()">gtk_entry_grab_focus_without_selecting</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkEntry.properties"></a><h2>Properties</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="properties_type">
<col width="300px" class="properties_name">
<col width="200px" class="properties_flags">
</colgroup>
<tbody>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--activates-default" title="The “activates-default” property">activates-default</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">PangoAttrList</span> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--attributes" title="The “attributes” property">attributes</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--buffer" title="The “buffer” property">buffer</a></td>
<td class="property_flags">Read / Write / Construct</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--caps-lock-warning" title="The “caps-lock-warning” property">caps-lock-warning</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--completion" title="The “completion” property">completion</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">int</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--cursor-position" title="The “cursor-position” property">cursor-position</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--editable" title="The “editable” property">editable</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--enable-emoji-completion" title="The “enable-emoji-completion” property">enable-emoji-completion</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--has-frame" title="The “has-frame” property">has-frame</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--im-module" title="The “im-module” property">im-module</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--inner-border" title="The “inner-border” property">inner-border</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a class="link" href="GtkEntry.html#GtkInputHints" title="enum GtkInputHints"><span class="type">GtkInputHints</span></a></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--input-hints" title="The “input-hints” property">input-hints</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a class="link" href="GtkEntry.html#GtkInputPurpose" title="enum GtkInputPurpose"><span class="type">GtkInputPurpose</span></a></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--input-purpose" title="The “input-purpose” property">input-purpose</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">guint</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--invisible-char" title="The “invisible-char” property">invisible-char</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--invisible-char-set" title="The “invisible-char-set” property">invisible-char-set</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">int</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--max-length" title="The “max-length” property">max-length</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">int</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--max-width-chars" title="The “max-width-chars” property">max-width-chars</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--overwrite-mode" title="The “overwrite-mode” property">overwrite-mode</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--placeholder-text" title="The “placeholder-text” property">placeholder-text</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--populate-all" title="The “populate-all” property">populate-all</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--primary-icon-activatable" title="The “primary-icon-activatable” property">primary-icon-activatable</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">GIcon</span> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--primary-icon-gicon" title="The “primary-icon-gicon” property">primary-icon-gicon</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--primary-icon-name" title="The “primary-icon-name” property">primary-icon-name</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">GdkPixbuf</span> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--primary-icon-pixbuf" title="The “primary-icon-pixbuf” property">primary-icon-pixbuf</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--primary-icon-sensitive" title="The “primary-icon-sensitive” property">primary-icon-sensitive</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--primary-icon-stock" title="The “primary-icon-stock” property">primary-icon-stock</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a class="link" href="GtkImage.html#GtkImageType" title="enum GtkImageType"><span class="type">GtkImageType</span></a></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--primary-icon-storage-type" title="The “primary-icon-storage-type” property">primary-icon-storage-type</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--primary-icon-tooltip-markup" title="The “primary-icon-tooltip-markup” property">primary-icon-tooltip-markup</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--primary-icon-tooltip-text" title="The “primary-icon-tooltip-text” property">primary-icon-tooltip-text</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">double</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--progress-fraction" title="The “progress-fraction” property">progress-fraction</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">double</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--progress-pulse-step" title="The “progress-pulse-step” property">progress-pulse-step</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">int</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--scroll-offset" title="The “scroll-offset” property">scroll-offset</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-activatable" title="The “secondary-icon-activatable” property">secondary-icon-activatable</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">GIcon</span> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-gicon" title="The “secondary-icon-gicon” property">secondary-icon-gicon</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-name" title="The “secondary-icon-name” property">secondary-icon-name</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">GdkPixbuf</span> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-pixbuf" title="The “secondary-icon-pixbuf” property">secondary-icon-pixbuf</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-sensitive" title="The “secondary-icon-sensitive” property">secondary-icon-sensitive</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-stock" title="The “secondary-icon-stock” property">secondary-icon-stock</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a class="link" href="GtkImage.html#GtkImageType" title="enum GtkImageType"><span class="type">GtkImageType</span></a></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-storage-type" title="The “secondary-icon-storage-type” property">secondary-icon-storage-type</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-tooltip-markup" title="The “secondary-icon-tooltip-markup” property">secondary-icon-tooltip-markup</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-tooltip-text" title="The “secondary-icon-tooltip-text” property">secondary-icon-tooltip-text</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">int</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--selection-bound" title="The “selection-bound” property">selection-bound</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type"><a class="link" href="gtk3-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType"><span class="type">GtkShadowType</span></a></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--shadow-type" title="The “shadow-type” property">shadow-type</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--show-emoji-icon" title="The “show-emoji-icon” property">show-emoji-icon</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">PangoTabArray</span> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--tabs" title="The “tabs” property">tabs</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--text" title="The “text” property">text</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">guint</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--text-length" title="The “text-length” property">text-length</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--truncate-multiline" title="The “truncate-multiline” property">truncate-multiline</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--visibility" title="The “visibility” property">visibility</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">int</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--width-chars" title="The “width-chars” property">width-chars</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">float</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--xalign" title="The “xalign” property">xalign</a></td>
<td class="property_flags">Read / Write</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkEntry.style-properties"></a><h2>Style Properties</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="style_properties_type">
<col width="300px" class="style_properties_name">
<col width="200px" class="style_properties_flags">
</colgroup>
<tbody>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--s-icon-prelight" title="The “icon-prelight” style property">icon-prelight</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type">
<a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--s-inner-border" title="The “inner-border” style property">inner-border</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type"><span class="type">guint</span></td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--s-invisible-char" title="The “invisible-char” style property">invisible-char</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type">
<a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a> *</td>
<td class="property_name"><a class="link" href="GtkEntry.html#GtkEntry--s-progress-border" title="The “progress-border” style property">progress-border</a></td>
<td class="property_flags">Read</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkEntry.signals"></a><h2>Signals</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="signal_proto_type">
<col width="300px" class="signal_proto_name">
<col width="200px" class="signal_proto_flags">
</colgroup>
<tbody>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-activate" title="The “activate” signal">activate</a></td>
<td class="signal_flags">Action</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-backspace" title="The “backspace” signal">backspace</a></td>
<td class="signal_flags">Action</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-copy-clipboard" title="The “copy-clipboard” signal">copy-clipboard</a></td>
<td class="signal_flags">Action</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-cut-clipboard" title="The “cut-clipboard” signal">cut-clipboard</a></td>
<td class="signal_flags">Action</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-delete-from-cursor" title="The “delete-from-cursor” signal">delete-from-cursor</a></td>
<td class="signal_flags">Action</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-icon-press" title="The “icon-press” signal">icon-press</a></td>
<td class="signal_flags">Run Last</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-icon-release" title="The “icon-release” signal">icon-release</a></td>
<td class="signal_flags">Run Last</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-insert-at-cursor" title="The “insert-at-cursor” signal">insert-at-cursor</a></td>
<td class="signal_flags">Action</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-insert-emoji" title="The “insert-emoji” signal">insert-emoji</a></td>
<td class="signal_flags">Action</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-move-cursor" title="The “move-cursor” signal">move-cursor</a></td>
<td class="signal_flags">Action</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-paste-clipboard" title="The “paste-clipboard” signal">paste-clipboard</a></td>
<td class="signal_flags">Action</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-populate-popup" title="The “populate-popup” signal">populate-popup</a></td>
<td class="signal_flags">Run Last</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-preedit-changed" title="The “preedit-changed” signal">preedit-changed</a></td>
<td class="signal_flags">Action</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkEntry.html#GtkEntry-toggle-overwrite" title="The “toggle-overwrite” signal">toggle-overwrite</a></td>
<td class="signal_flags">Action</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkEntry.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="other_proto_type">
<col class="other_proto_name">
</colgroup>
<tbody>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="GtkEntry.html#GtkEntry-struct" title="struct GtkEntry">GtkEntry</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="GtkEntry.html#GtkEntryClass" title="struct GtkEntryClass">GtkEntryClass</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition">GtkEntryIconPosition</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="GtkEntry.html#GtkInputPurpose" title="enum GtkInputPurpose">GtkInputPurpose</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="GtkEntry.html#GtkInputHints" title="enum GtkInputHints">GtkInputHints</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkEntry.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen">    GObject
    <span class="lineart">╰──</span> GInitiallyUnowned
        <span class="lineart">╰──</span> <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
            <span class="lineart">╰──</span> GtkEntry
                <span class="lineart">├──</span> <a class="link" href="GtkSearchEntry.html" title="GtkSearchEntry">GtkSearchEntry</a>
                <span class="lineart">╰──</span> <a class="link" href="GtkSpinButton.html" title="GtkSpinButton">GtkSpinButton</a>
</pre>
</div>
<div class="refsect1">
<a name="GtkEntry.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GtkEntry implements
 AtkImplementorIface,  <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>,  <a class="link" href="GtkEditable.html" title="GtkEditable">GtkEditable</a> and  <a class="link" href="GtkCellEditable.html" title="GtkCellEditable">GtkCellEditable</a>.</p>
</div>
<div class="refsect1">
<a name="GtkEntry.includes"></a><h2>Includes</h2>
<pre class="synopsis">#include &lt;gtk/gtk.h&gt;
</pre>
</div>
<div class="refsect1">
<a name="GtkEntry.description"></a><h2>Description</h2>
<p>The <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> widget is a single line text entry
widget. A fairly large set of key bindings are supported
by default. If the entered text is longer than the allocation
of the widget, the widget will scroll so that the cursor
position is visible.</p>
<p>When using an entry for passwords and other sensitive information,
it can be put into “password mode” using <a class="link" href="GtkEntry.html#gtk-entry-set-visibility" title="gtk_entry_set_visibility ()"><code class="function">gtk_entry_set_visibility()</code></a>.
In this mode, entered text is displayed using a “invisible” character.
By default, GTK+ picks the best invisible character that is available
in the current font, but it can be changed with
<a class="link" href="GtkEntry.html#gtk-entry-set-invisible-char" title="gtk_entry_set_invisible_char ()"><code class="function">gtk_entry_set_invisible_char()</code></a>. Since 2.16, GTK+ displays a warning
when Caps Lock or input methods might interfere with entering text in
a password entry. The warning can be turned off with the
<a class="link" href="GtkEntry.html#GtkEntry--caps-lock-warning" title="The “caps-lock-warning” property"><span class="type">“caps-lock-warning”</span></a> property.</p>
<p>Since 2.16, GtkEntry has the ability to display progress or activity
information behind the text. To make an entry display such information,
use <a class="link" href="GtkEntry.html#gtk-entry-set-progress-fraction" title="gtk_entry_set_progress_fraction ()"><code class="function">gtk_entry_set_progress_fraction()</code></a> or <a class="link" href="GtkEntry.html#gtk-entry-set-progress-pulse-step" title="gtk_entry_set_progress_pulse_step ()"><code class="function">gtk_entry_set_progress_pulse_step()</code></a>.</p>
<p>Additionally, GtkEntry can show icons at either side of the entry. These
icons can be activatable by clicking, can be set up as drag source and
can have tooltips. To add an icon, use <a class="link" href="GtkEntry.html#gtk-entry-set-icon-from-gicon" title="gtk_entry_set_icon_from_gicon ()"><code class="function">gtk_entry_set_icon_from_gicon()</code></a> or
one of the various other functions that set an icon from a stock id, an
icon name or a pixbuf. To trigger an action when the user clicks an icon,
connect to the <a class="link" href="GtkEntry.html#GtkEntry-icon-press" title="The “icon-press” signal"><span class="type">“icon-press”</span></a> signal. To allow DND operations
from an icon, use <a class="link" href="GtkEntry.html#gtk-entry-set-icon-drag-source" title="gtk_entry_set_icon_drag_source ()"><code class="function">gtk_entry_set_icon_drag_source()</code></a>. To set a tooltip on
an icon, use <a class="link" href="GtkEntry.html#gtk-entry-set-icon-tooltip-text" title="gtk_entry_set_icon_tooltip_text ()"><code class="function">gtk_entry_set_icon_tooltip_text()</code></a> or the corresponding function
for markup.</p>
<p>Note that functionality or information that is only available by clicking
on an icon in an entry may not be accessible at all to users which are not
able to use a mouse or other pointing device. It is therefore recommended
that any such functionality should also be available by other means, e.g.
via the context menu of the entry.</p>
<div class="refsect2">
<a name="id-1.3.10.2.11.7"></a><h3>CSS nodes</h3>
<div class="informalexample">
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
    <tbody>
      <tr>
        <td class="listing_lines" align="right"><pre>1
2
3
4
5
6
7
8</pre></td>
        <td class="listing_code"><pre class="programlisting"><span class="n">entry</span><span class="p">[.</span><span class="n">read</span><span class="o">-</span><span class="n">only</span><span class="p">][.</span><span class="n">flat</span><span class="p">][.</span><span class="n">warning</span><span class="p">][.</span><span class="n">error</span><span class="p">]</span>
<span class="err">├──</span> <span class="n">image</span><span class="p">.</span><span class="n">left</span>
<span class="err">├──</span> <span class="n">image</span><span class="p">.</span><span class="n">right</span>
<span class="err">├──</span> <span class="n">undershoot</span><span class="p">.</span><span class="n">left</span>
<span class="err">├──</span> <span class="n">undershoot</span><span class="p">.</span><span class="n">right</span>
<span class="err">├──</span> <span class="p">[</span><span class="n">selection</span><span class="p">]</span>
<span class="err">├──</span> <span class="p">[</span><span class="n">progress</span><span class="p">[.</span><span class="n">pulse</span><span class="p">]]</span>
<span class="err">╰──</span> <span class="p">[</span><span class="n">window</span><span class="p">.</span><span class="n">popup</span><span class="p">]</span></pre></td>
      </tr>
    </tbody>
  </table>
</div>

<p></p>
<p>GtkEntry has a main node with the name entry. Depending on the properties
of the entry, the style classes .read-only and .flat may appear. The style
classes .warning and .error may also be used with entries.</p>
<p>When the entry shows icons, it adds subnodes with the name image and the
style class .left or .right, depending on where the icon appears.</p>
<p>When the entry has a selection, it adds a subnode with the name selection.</p>
<p>When the entry shows progress, it adds a subnode with the name progress.
The node has the style class .pulse when the shown progress is pulsing.</p>
<p>The CSS node for a context menu is added as a subnode below entry as well.</p>
<p>The undershoot nodes are used to draw the underflow indication when content
is scrolled out of view. These nodes get the .left and .right style classes
added depending on where the indication is drawn.</p>
<p>When touch is used and touch selection handles are shown, they are using
CSS nodes with name cursor-handle. They get the .top or .bottom style class
depending on where they are shown in relation to the selection. If there is
just a single handle for the text cursor, it gets the style class
.insertion-cursor.</p>
</div>
</div>
<div class="refsect1">
<a name="GtkEntry.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gtk-entry-new"></a><h3>gtk_entry_new ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_entry_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>Creates a new entry.</p>
<div class="refsect3">
<a name="gtk-entry-new.returns"></a><h4>Returns</h4>
<p> a new <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-new-with-buffer"></a><h3>gtk_entry_new_with_buffer ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_entry_new_with_buffer (<em class="parameter"><code><a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> *buffer</code></em>);</pre>
<p>Creates a new entry with the specified text buffer.</p>
<div class="refsect3">
<a name="gtk-entry-new-with-buffer.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>buffer</p></td>
<td class="parameter_description"><p>The buffer to use for the new <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-new-with-buffer.returns"></a><h4>Returns</h4>
<p> a new <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p>
</div>
<p class="since">Since: 2.18</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-buffer"></a><h3>gtk_entry_get_buffer ()</h3>
<pre class="programlisting"><a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="returnvalue">GtkEntryBuffer</span></a> *
gtk_entry_get_buffer (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Get the <a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> object which holds the text for
this widget.</p>
<div class="refsect3">
<a name="gtk-entry-get-buffer.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-buffer.returns"></a><h4>Returns</h4>
<p>A <a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> object. </p>
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.18</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-buffer"></a><h3>gtk_entry_set_buffer ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_buffer (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                      <em class="parameter"><code><a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> *buffer</code></em>);</pre>
<p>Set the <a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> object which holds the text for
this widget.</p>
<div class="refsect3">
<a name="gtk-entry-set-buffer.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>buffer</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.18</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-text"></a><h3>gtk_entry_set_text ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_text (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                    <em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);</pre>
<p>Sets the text in the widget to the given
value, replacing the current contents.</p>
<p>See <a class="link" href="GtkEntryBuffer.html#gtk-entry-buffer-set-text" title="gtk_entry_buffer_set_text ()"><code class="function">gtk_entry_buffer_set_text()</code></a>.</p>
<div class="refsect3">
<a name="gtk-entry-set-text.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>text</p></td>
<td class="parameter_description"><p>the new text</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-text"></a><h3>gtk_entry_get_text ()</h3>
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_entry_get_text (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Retrieves the contents of the entry widget.
See also <a class="link" href="GtkEditable.html#gtk-editable-get-chars" title="gtk_editable_get_chars ()"><code class="function">gtk_editable_get_chars()</code></a>.</p>
<p>This is equivalent to getting <em class="parameter"><code>entry</code></em>
's <a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> and calling
<a class="link" href="GtkEntryBuffer.html#gtk-entry-buffer-get-text" title="gtk_entry_buffer_get_text ()"><code class="function">gtk_entry_buffer_get_text()</code></a> on it.</p>
<div class="refsect3">
<a name="gtk-entry-get-text.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-text.returns"></a><h4>Returns</h4>
<p> a pointer to the contents of the widget as a
string. This string points to internally allocated
storage in the widget and must not be freed, modified or
stored.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-text-length"></a><h3>gtk_entry_get_text_length ()</h3>
<pre class="programlisting"><span class="returnvalue">guint16</span>
gtk_entry_get_text_length (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Retrieves the current length of the text in
<em class="parameter"><code>entry</code></em>
. </p>
<p>This is equivalent to getting <em class="parameter"><code>entry</code></em>
's <a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> and
calling <a class="link" href="GtkEntryBuffer.html#gtk-entry-buffer-get-length" title="gtk_entry_buffer_get_length ()"><code class="function">gtk_entry_buffer_get_length()</code></a> on it.</p>
<div class="refsect3">
<a name="gtk-entry-get-text-length.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-text-length.returns"></a><h4>Returns</h4>
<p> the current number of characters
in <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>, or 0 if there are none.</p>
</div>
<p class="since">Since: 2.14</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-text-area"></a><h3>gtk_entry_get_text_area ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_get_text_area (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                         <em class="parameter"><code><span class="type">GdkRectangle</span> *text_area</code></em>);</pre>
<p>Gets the area where the entry’s text is drawn. This function is
useful when drawing something to the entry in a draw callback.</p>
<p>If the entry is not realized, <em class="parameter"><code>text_area</code></em>
 is filled with zeros.</p>
<p>See also <a class="link" href="GtkEntry.html#gtk-entry-get-icon-area" title="gtk_entry_get_icon_area ()"><code class="function">gtk_entry_get_icon_area()</code></a>.</p>
<div class="refsect3">
<a name="gtk-entry-get-text-area.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>text_area</p></td>
<td class="parameter_description"><p>Return location for the text area. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-visibility"></a><h3>gtk_entry_set_visibility ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_visibility (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                          <em class="parameter"><code><span class="type">gboolean</span> visible</code></em>);</pre>
<p>Sets whether the contents of the entry are visible or not.
When visibility is set to <code class="literal">FALSE</code>, characters are displayed
as the invisible char, and will also appear that way when
the text in the entry widget is copied elsewhere.</p>
<p>By default, GTK+ picks the best invisible character available
in the current font, but it can be changed with
<a class="link" href="GtkEntry.html#gtk-entry-set-invisible-char" title="gtk_entry_set_invisible_char ()"><code class="function">gtk_entry_set_invisible_char()</code></a>.</p>
<p>Note that you probably want to set <a class="link" href="GtkEntry.html#GtkEntry--input-purpose" title="The “input-purpose” property"><span class="type">“input-purpose”</span></a>
to <a class="link" href="GtkEntry.html#GTK-INPUT-PURPOSE-PASSWORD:CAPS"><code class="literal">GTK_INPUT_PURPOSE_PASSWORD</code></a> or <a class="link" href="GtkEntry.html#GTK-INPUT-PURPOSE-PIN:CAPS"><code class="literal">GTK_INPUT_PURPOSE_PIN</code></a> to
inform input methods about the purpose of this entry,
in addition to setting visibility to <code class="literal">FALSE</code>.</p>
<div class="refsect3">
<a name="gtk-entry-set-visibility.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>visible</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> if the contents of the entry are displayed
as plaintext</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-invisible-char"></a><h3>gtk_entry_set_invisible_char ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_invisible_char (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                              <em class="parameter"><code><span class="type">gunichar</span> ch</code></em>);</pre>
<p>Sets the character to use in place of the actual text when
<a class="link" href="GtkEntry.html#gtk-entry-set-visibility" title="gtk_entry_set_visibility ()"><code class="function">gtk_entry_set_visibility()</code></a> has been called to set text visibility
to <code class="literal">FALSE</code>. i.e. this is the character used in “password mode” to
show the user how many characters have been typed. By default, GTK+
picks the best invisible char available in the current font. If you
set the invisible char to 0, then the user will get no feedback
at all; there will be no text on the screen as they type.</p>
<div class="refsect3">
<a name="gtk-entry-set-invisible-char.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>ch</p></td>
<td class="parameter_description"><p>a Unicode character</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-unset-invisible-char"></a><h3>gtk_entry_unset_invisible_char ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_unset_invisible_char (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Unsets the invisible char previously set with
<a class="link" href="GtkEntry.html#gtk-entry-set-invisible-char" title="gtk_entry_set_invisible_char ()"><code class="function">gtk_entry_set_invisible_char()</code></a>. So that the
default invisible char is used again.</p>
<div class="refsect3">
<a name="gtk-entry-unset-invisible-char.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-max-length"></a><h3>gtk_entry_set_max_length ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_max_length (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                          <em class="parameter"><code><span class="type">gint</span> max</code></em>);</pre>
<p>Sets the maximum allowed length of the contents of the widget. If
the current contents are longer than the given length, then they
will be truncated to fit.</p>
<p>This is equivalent to getting <em class="parameter"><code>entry</code></em>
's <a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> and
calling <a class="link" href="GtkEntryBuffer.html#gtk-entry-buffer-set-max-length" title="gtk_entry_buffer_set_max_length ()"><code class="function">gtk_entry_buffer_set_max_length()</code></a> on it.
]|</p>
<div class="refsect3">
<a name="gtk-entry-set-max-length.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>max</p></td>
<td class="parameter_description"><p>the maximum length of the entry, or 0 for no maximum.
(other than the maximum length of entries.) The value passed in will
be clamped to the range 0-65536.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-activates-default"></a><h3>gtk_entry_get_activates_default ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_entry_get_activates_default (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Retrieves the value set by <a class="link" href="GtkEntry.html#gtk-entry-set-activates-default" title="gtk_entry_set_activates_default ()"><code class="function">gtk_entry_set_activates_default()</code></a>.</p>
<div class="refsect3">
<a name="gtk-entry-get-activates-default.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-activates-default.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the entry will activate the default widget</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-has-frame"></a><h3>gtk_entry_get_has_frame ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_entry_get_has_frame (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Gets the value set by <a class="link" href="GtkEntry.html#gtk-entry-set-has-frame" title="gtk_entry_set_has_frame ()"><code class="function">gtk_entry_set_has_frame()</code></a>.</p>
<div class="refsect3">
<a name="gtk-entry-get-has-frame.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-has-frame.returns"></a><h4>Returns</h4>
<p> whether the entry has a beveled frame</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-inner-border"></a><h3>gtk_entry_get_inner_border ()</h3>
<pre class="programlisting">const <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="returnvalue">GtkBorder</span></a> *
gtk_entry_get_inner_border (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_entry_get_inner_border</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>Use the standard border and padding CSS properties (through
  objects like <a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> and <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a>); the value returned by
  this function is ignored by <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>.</p>
</div>
<p>This function returns the entry’s <a class="link" href="GtkEntry.html#GtkEntry--inner-border" title="The “inner-border” property"><span class="type">“inner-border”</span></a> property. See
<a class="link" href="GtkEntry.html#gtk-entry-set-inner-border" title="gtk_entry_set_inner_border ()"><code class="function">gtk_entry_set_inner_border()</code></a> for more information.</p>
<div class="refsect3">
<a name="gtk-entry-get-inner-border.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-inner-border.returns"></a><h4>Returns</h4>
<p>the entry’s <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a>, or
<code class="literal">NULL</code> if none was set. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-width-chars"></a><h3>gtk_entry_get_width_chars ()</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
gtk_entry_get_width_chars (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Gets the value set by <a class="link" href="GtkEntry.html#gtk-entry-set-width-chars" title="gtk_entry_set_width_chars ()"><code class="function">gtk_entry_set_width_chars()</code></a>.</p>
<div class="refsect3">
<a name="gtk-entry-get-width-chars.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-width-chars.returns"></a><h4>Returns</h4>
<p> number of chars to request space for, or negative if unset</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-max-width-chars"></a><h3>gtk_entry_get_max_width_chars ()</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
gtk_entry_get_max_width_chars (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Retrieves the desired maximum width of <em class="parameter"><code>entry</code></em>
, in characters.
See <a class="link" href="GtkEntry.html#gtk-entry-set-max-width-chars" title="gtk_entry_set_max_width_chars ()"><code class="function">gtk_entry_set_max_width_chars()</code></a>.</p>
<div class="refsect3">
<a name="gtk-entry-get-max-width-chars.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-max-width-chars.returns"></a><h4>Returns</h4>
<p> the maximum width of the entry, in characters</p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-12.html#api-index-3.12">3.12</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-activates-default"></a><h3>gtk_entry_set_activates_default ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_activates_default (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                                 <em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
<p>If <em class="parameter"><code>setting</code></em>
 is <code class="literal">TRUE</code>, pressing Enter in the <em class="parameter"><code>entry</code></em>
 will activate the default
widget for the window containing the entry. This usually means that
the dialog box containing the entry will be closed, since the default
widget is usually one of the dialog buttons.</p>
<p>(For experts: if <em class="parameter"><code>setting</code></em>
 is <code class="literal">TRUE</code>, the entry calls
<a class="link" href="GtkWindow.html#gtk-window-activate-default" title="gtk_window_activate_default ()"><code class="function">gtk_window_activate_default()</code></a> on the window containing the entry, in
the default handler for the <a class="link" href="GtkEntry.html#GtkEntry-activate" title="The “activate” signal"><span class="type">“activate”</span></a> signal.)</p>
<div class="refsect3">
<a name="gtk-entry-set-activates-default.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>setting</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> to activate window’s default widget on Enter keypress</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-has-frame"></a><h3>gtk_entry_set_has_frame ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_has_frame (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                         <em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
<p>Sets whether the entry has a beveled frame around it.</p>
<div class="refsect3">
<a name="gtk-entry-set-has-frame.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>setting</p></td>
<td class="parameter_description"><p>new value</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-inner-border"></a><h3>gtk_entry_set_inner_border ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_inner_border (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                            <em class="parameter"><code>const <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a> *border</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_entry_set_inner_border</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>Use the standard border and padding CSS properties (through
  objects like <a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> and <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a>); the value set with
  this function is ignored by <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>.</p>
</div>
<p>Sets <code class="literal">entry</code>’s inner-border property to <em class="parameter"><code>border</code></em>
, or clears it if <code class="literal">NULL</code>
is passed. The inner-border is the area around the entry’s text, but
inside its frame.</p>
<p>If set, this property overrides the inner-border style property.
Overriding the style-provided border is useful when you want to do
in-place editing of some text in a canvas or list widget, where
pixel-exact positioning of the entry is important.</p>
<div class="refsect3">
<a name="gtk-entry-set-inner-border.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>border</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a>, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-width-chars"></a><h3>gtk_entry_set_width_chars ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_width_chars (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                           <em class="parameter"><code><span class="type">gint</span> n_chars</code></em>);</pre>
<p>Changes the size request of the entry to be about the right size
for <em class="parameter"><code>n_chars</code></em>
 characters. Note that it changes the size
request, the size can still be affected by
how you pack the widget into containers. If <em class="parameter"><code>n_chars</code></em>
 is -1, the
size reverts to the default entry size.</p>
<div class="refsect3">
<a name="gtk-entry-set-width-chars.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>n_chars</p></td>
<td class="parameter_description"><p>width in chars</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-max-width-chars"></a><h3>gtk_entry_set_max_width_chars ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_max_width_chars (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                               <em class="parameter"><code><span class="type">gint</span> n_chars</code></em>);</pre>
<p>Sets the desired maximum width in characters of <em class="parameter"><code>entry</code></em>
.</p>
<div class="refsect3">
<a name="gtk-entry-set-max-width-chars.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>n_chars</p></td>
<td class="parameter_description"><p>the new desired maximum width, in characters</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-12.html#api-index-3.12">3.12</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-invisible-char"></a><h3>gtk_entry_get_invisible_char ()</h3>
<pre class="programlisting"><span class="returnvalue">gunichar</span>
gtk_entry_get_invisible_char (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Retrieves the character displayed in place of the real characters
for entries with visibility set to false. See <a class="link" href="GtkEntry.html#gtk-entry-set-invisible-char" title="gtk_entry_set_invisible_char ()"><code class="function">gtk_entry_set_invisible_char()</code></a>.</p>
<div class="refsect3">
<a name="gtk-entry-get-invisible-char.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-invisible-char.returns"></a><h4>Returns</h4>
<p> the current invisible char, or 0, if the entry does not
show invisible text at all. </p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-alignment"></a><h3>gtk_entry_set_alignment ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_alignment (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                         <em class="parameter"><code><span class="type">gfloat</span> xalign</code></em>);</pre>
<p>Sets the alignment for the contents of the entry. This controls
the horizontal positioning of the contents when the displayed
text is shorter than the width of the entry.</p>
<div class="refsect3">
<a name="gtk-entry-set-alignment.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>xalign</p></td>
<td class="parameter_description"><p>The horizontal alignment, from 0 (left) to 1 (right).
Reversed for RTL layouts</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-alignment"></a><h3>gtk_entry_get_alignment ()</h3>
<pre class="programlisting"><span class="returnvalue">gfloat</span>
gtk_entry_get_alignment (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Gets the value set by <a class="link" href="GtkEntry.html#gtk-entry-set-alignment" title="gtk_entry_set_alignment ()"><code class="function">gtk_entry_set_alignment()</code></a>.</p>
<div class="refsect3">
<a name="gtk-entry-get-alignment.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-alignment.returns"></a><h4>Returns</h4>
<p> the alignment</p>
</div>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-placeholder-text"></a><h3>gtk_entry_set_placeholder_text ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_placeholder_text (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                                <em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);</pre>
<p>Sets text to be displayed in <em class="parameter"><code>entry</code></em>
 when it is empty and unfocused.
This can be used to give a visual hint of the expected contents of
the <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>.</p>
<p>Note that since the placeholder text gets removed when the entry
received focus, using this feature is a bit problematic if the entry
is given the initial focus in a window. Sometimes this can be
worked around by delaying the initial focus setting until the
first key event arrives.</p>
<div class="refsect3">
<a name="gtk-entry-set-placeholder-text.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>text</p></td>
<td class="parameter_description"><p>a string to be displayed when <em class="parameter"><code>entry</code></em>
is empty and unfocused, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-2.html#api-index-3.2">3.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-placeholder-text"></a><h3>gtk_entry_get_placeholder_text ()</h3>
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_entry_get_placeholder_text (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Retrieves the text that will be displayed when <em class="parameter"><code>entry</code></em>
 is empty and unfocused</p>
<div class="refsect3">
<a name="gtk-entry-get-placeholder-text.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-placeholder-text.returns"></a><h4>Returns</h4>
<p> a pointer to the placeholder text as a string. This string points to internally allocated
storage in the widget and must not be freed, modified or stored.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-2.html#api-index-3.2">3.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-overwrite-mode"></a><h3>gtk_entry_set_overwrite_mode ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_overwrite_mode (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                              <em class="parameter"><code><span class="type">gboolean</span> overwrite</code></em>);</pre>
<p>Sets whether the text is overwritten when typing in the <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>.</p>
<div class="refsect3">
<a name="gtk-entry-set-overwrite-mode.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>overwrite</p></td>
<td class="parameter_description"><p>new value</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.14</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-overwrite-mode"></a><h3>gtk_entry_get_overwrite_mode ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_entry_get_overwrite_mode (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Gets the value set by <a class="link" href="GtkEntry.html#gtk-entry-set-overwrite-mode" title="gtk_entry_set_overwrite_mode ()"><code class="function">gtk_entry_set_overwrite_mode()</code></a>.</p>
<div class="refsect3">
<a name="gtk-entry-get-overwrite-mode.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-overwrite-mode.returns"></a><h4>Returns</h4>
<p> whether the text is overwritten when typing.</p>
</div>
<p class="since">Since: 2.14</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-layout"></a><h3>gtk_entry_get_layout ()</h3>
<pre class="programlisting"><span class="returnvalue">PangoLayout</span> *
gtk_entry_get_layout (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Gets the <span class="type">PangoLayout</span> used to display the entry.
The layout is useful to e.g. convert text positions to
pixel positions, in combination with <a class="link" href="GtkEntry.html#gtk-entry-get-layout-offsets" title="gtk_entry_get_layout_offsets ()"><code class="function">gtk_entry_get_layout_offsets()</code></a>.
The returned layout is owned by the entry and must not be 
modified or freed by the caller.</p>
<p>Keep in mind that the layout text may contain a preedit string, so
<a class="link" href="GtkEntry.html#gtk-entry-layout-index-to-text-index" title="gtk_entry_layout_index_to_text_index ()"><code class="function">gtk_entry_layout_index_to_text_index()</code></a> and
<a class="link" href="GtkEntry.html#gtk-entry-text-index-to-layout-index" title="gtk_entry_text_index_to_layout_index ()"><code class="function">gtk_entry_text_index_to_layout_index()</code></a> are needed to convert byte
indices in the layout to byte indices in the entry contents.</p>
<div class="refsect3">
<a name="gtk-entry-get-layout.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-layout.returns"></a><h4>Returns</h4>
<p>the <span class="type">PangoLayout</span> for this entry. </p>
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-layout-offsets"></a><h3>gtk_entry_get_layout_offsets ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_get_layout_offsets (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                              <em class="parameter"><code><span class="type">gint</span> *x</code></em>,
                              <em class="parameter"><code><span class="type">gint</span> *y</code></em>);</pre>
<p>Obtains the position of the <span class="type">PangoLayout</span> used to render text
in the entry, in widget coordinates. Useful if you want to line
up the text in an entry with some other text, e.g. when using the
entry to implement editable cells in a sheet widget.</p>
<p>Also useful to convert mouse events into coordinates inside the
<span class="type">PangoLayout</span>, e.g. to take some action if some part of the entry text
is clicked.</p>
<p>Note that as the user scrolls around in the entry the offsets will
change; you’ll need to connect to the “notify::scroll-offset”
signal to track this. Remember when using the <span class="type">PangoLayout</span>
functions you need to convert to and from pixels using
<code class="function">PANGO_PIXELS()</code> or <span class="type">PANGO_SCALE</span>.</p>
<p>Keep in mind that the layout text may contain a preedit string, so
<a class="link" href="GtkEntry.html#gtk-entry-layout-index-to-text-index" title="gtk_entry_layout_index_to_text_index ()"><code class="function">gtk_entry_layout_index_to_text_index()</code></a> and
<a class="link" href="GtkEntry.html#gtk-entry-text-index-to-layout-index" title="gtk_entry_text_index_to_layout_index ()"><code class="function">gtk_entry_text_index_to_layout_index()</code></a> are needed to convert byte
indices in the layout to byte indices in the entry contents.</p>
<div class="refsect3">
<a name="gtk-entry-get-layout-offsets.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>x</p></td>
<td class="parameter_description"><p>location to store X offset of layout, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>y</p></td>
<td class="parameter_description"><p>location to store Y offset of layout, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-layout-index-to-text-index"></a><h3>gtk_entry_layout_index_to_text_index ()</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
gtk_entry_layout_index_to_text_index (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                                      <em class="parameter"><code><span class="type">gint</span> layout_index</code></em>);</pre>
<p>Converts from a position in the entry’s <span class="type">PangoLayout</span> (returned by
<a class="link" href="GtkEntry.html#gtk-entry-get-layout" title="gtk_entry_get_layout ()"><code class="function">gtk_entry_get_layout()</code></a>) to a position in the entry contents
(returned by <a class="link" href="GtkEntry.html#gtk-entry-get-text" title="gtk_entry_get_text ()"><code class="function">gtk_entry_get_text()</code></a>).</p>
<div class="refsect3">
<a name="gtk-entry-layout-index-to-text-index.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>layout_index</p></td>
<td class="parameter_description"><p>byte index into the entry layout text</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-layout-index-to-text-index.returns"></a><h4>Returns</h4>
<p> byte index into the entry contents</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-text-index-to-layout-index"></a><h3>gtk_entry_text_index_to_layout_index ()</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
gtk_entry_text_index_to_layout_index (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                                      <em class="parameter"><code><span class="type">gint</span> text_index</code></em>);</pre>
<p>Converts from a position in the entry contents (returned
by <a class="link" href="GtkEntry.html#gtk-entry-get-text" title="gtk_entry_get_text ()"><code class="function">gtk_entry_get_text()</code></a>) to a position in the
entry’s <span class="type">PangoLayout</span> (returned by <a class="link" href="GtkEntry.html#gtk-entry-get-layout" title="gtk_entry_get_layout ()"><code class="function">gtk_entry_get_layout()</code></a>,
with text retrieved via <code class="function">pango_layout_get_text()</code>).</p>
<div class="refsect3">
<a name="gtk-entry-text-index-to-layout-index.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>text_index</p></td>
<td class="parameter_description"><p>byte index into the entry contents</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-text-index-to-layout-index.returns"></a><h4>Returns</h4>
<p> byte index into the entry layout text</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-attributes"></a><h3>gtk_entry_set_attributes ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_attributes (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                          <em class="parameter"><code><span class="type">PangoAttrList</span> *attrs</code></em>);</pre>
<p>Sets a <span class="type">PangoAttrList</span>; the attributes in the list are applied to the
entry text.</p>
<div class="refsect3">
<a name="gtk-entry-set-attributes.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attrs</p></td>
<td class="parameter_description"><p>a <span class="type">PangoAttrList</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-attributes"></a><h3>gtk_entry_get_attributes ()</h3>
<pre class="programlisting"><span class="returnvalue">PangoAttrList</span> *
gtk_entry_get_attributes (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Gets the attribute list that was set on the entry using
<a class="link" href="GtkEntry.html#gtk-entry-set-attributes" title="gtk_entry_set_attributes ()"><code class="function">gtk_entry_set_attributes()</code></a>, if any.</p>
<div class="refsect3">
<a name="gtk-entry-get-attributes.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-attributes.returns"></a><h4>Returns</h4>
<p>the attribute list, or <code class="literal">NULL</code>
if none was set. </p>
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-max-length"></a><h3>gtk_entry_get_max_length ()</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
gtk_entry_get_max_length (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Retrieves the maximum allowed length of the text in
<em class="parameter"><code>entry</code></em>
. See <a class="link" href="GtkEntry.html#gtk-entry-set-max-length" title="gtk_entry_set_max_length ()"><code class="function">gtk_entry_set_max_length()</code></a>.</p>
<p>This is equivalent to getting <em class="parameter"><code>entry</code></em>
's <a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> and
calling <a class="link" href="GtkEntryBuffer.html#gtk-entry-buffer-get-max-length" title="gtk_entry_buffer_get_max_length ()"><code class="function">gtk_entry_buffer_get_max_length()</code></a> on it.</p>
<div class="refsect3">
<a name="gtk-entry-get-max-length.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-max-length.returns"></a><h4>Returns</h4>
<p> the maximum allowed number of characters
in <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>, or 0 if there is no maximum.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-visibility"></a><h3>gtk_entry_get_visibility ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_entry_get_visibility (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Retrieves whether the text in <em class="parameter"><code>entry</code></em>
 is visible. See
<a class="link" href="GtkEntry.html#gtk-entry-set-visibility" title="gtk_entry_set_visibility ()"><code class="function">gtk_entry_set_visibility()</code></a>.</p>
<div class="refsect3">
<a name="gtk-entry-get-visibility.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-visibility.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the text is currently visible</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-completion"></a><h3>gtk_entry_set_completion ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_completion (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                          <em class="parameter"><code><a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *completion</code></em>);</pre>
<p>Sets <em class="parameter"><code>completion</code></em>
 to be the auxiliary completion object to use with <em class="parameter"><code>entry</code></em>
.
All further configuration of the completion mechanism is done on
<em class="parameter"><code>completion</code></em>
 using the <a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> API. Completion is disabled if
<em class="parameter"><code>completion</code></em>
 is set to <code class="literal">NULL</code>.</p>
<div class="refsect3">
<a name="gtk-entry-set-completion.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>completion</p></td>
<td class="parameter_description"><p>The <a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-completion"></a><h3>gtk_entry_get_completion ()</h3>
<pre class="programlisting"><a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion"><span class="returnvalue">GtkEntryCompletion</span></a> *
gtk_entry_get_completion (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Returns the auxiliary completion object currently in use by <em class="parameter"><code>entry</code></em>
.</p>
<div class="refsect3">
<a name="gtk-entry-get-completion.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-completion.returns"></a><h4>Returns</h4>
<p>The auxiliary completion object currently
in use by <em class="parameter"><code>entry</code></em>
. </p>
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-cursor-hadjustment"></a><h3>gtk_entry_set_cursor_hadjustment ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_cursor_hadjustment (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                                  <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *adjustment</code></em>);</pre>
<p>Hooks up an adjustment to the cursor position in an entry, so that when 
the cursor is moved, the adjustment is scrolled to show that position. 
See <a class="link" href="GtkScrolledWindow.html#gtk-scrolled-window-get-hadjustment" title="gtk_scrolled_window_get_hadjustment ()"><code class="function">gtk_scrolled_window_get_hadjustment()</code></a> for a typical way of obtaining 
the adjustment.</p>
<p>The adjustment has to be in pixel units and in the same coordinate system 
as the entry.</p>
<div class="refsect3">
<a name="gtk-entry-set-cursor-hadjustment.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>adjustment</p></td>
<td class="parameter_description"><p>an adjustment which should be adjusted when the cursor
is moved, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.12</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-cursor-hadjustment"></a><h3>gtk_entry_get_cursor_hadjustment ()</h3>
<pre class="programlisting"><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="returnvalue">GtkAdjustment</span></a> *
gtk_entry_get_cursor_hadjustment (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Retrieves the horizontal cursor adjustment for the entry. 
See <a class="link" href="GtkEntry.html#gtk-entry-set-cursor-hadjustment" title="gtk_entry_set_cursor_hadjustment ()"><code class="function">gtk_entry_set_cursor_hadjustment()</code></a>.</p>
<div class="refsect3">
<a name="gtk-entry-get-cursor-hadjustment.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-cursor-hadjustment.returns"></a><h4>Returns</h4>
<p>the horizontal cursor adjustment, or <code class="literal">NULL</code>
if none has been set. </p>
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.12</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-progress-fraction"></a><h3>gtk_entry_set_progress_fraction ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_progress_fraction (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                                 <em class="parameter"><code><span class="type">gdouble</span> fraction</code></em>);</pre>
<p>Causes the entry’s progress indicator to “fill in” the given
fraction of the bar. The fraction should be between 0.0 and 1.0,
inclusive.</p>
<div class="refsect3">
<a name="gtk-entry-set-progress-fraction.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>fraction</p></td>
<td class="parameter_description"><p>fraction of the task that’s been completed</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-progress-fraction"></a><h3>gtk_entry_get_progress_fraction ()</h3>
<pre class="programlisting"><span class="returnvalue">gdouble</span>
gtk_entry_get_progress_fraction (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Returns the current fraction of the task that’s been completed.
See <a class="link" href="GtkEntry.html#gtk-entry-set-progress-fraction" title="gtk_entry_set_progress_fraction ()"><code class="function">gtk_entry_set_progress_fraction()</code></a>.</p>
<div class="refsect3">
<a name="gtk-entry-get-progress-fraction.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-progress-fraction.returns"></a><h4>Returns</h4>
<p> a fraction from 0.0 to 1.0</p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-progress-pulse-step"></a><h3>gtk_entry_set_progress_pulse_step ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_progress_pulse_step (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                                   <em class="parameter"><code><span class="type">gdouble</span> fraction</code></em>);</pre>
<p>Sets the fraction of total entry width to move the progress
bouncing block for each call to <a class="link" href="GtkEntry.html#gtk-entry-progress-pulse" title="gtk_entry_progress_pulse ()"><code class="function">gtk_entry_progress_pulse()</code></a>.</p>
<div class="refsect3">
<a name="gtk-entry-set-progress-pulse-step.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>fraction</p></td>
<td class="parameter_description"><p>fraction between 0.0 and 1.0</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-progress-pulse-step"></a><h3>gtk_entry_get_progress_pulse_step ()</h3>
<pre class="programlisting"><span class="returnvalue">gdouble</span>
gtk_entry_get_progress_pulse_step (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Retrieves the pulse step set with <a class="link" href="GtkEntry.html#gtk-entry-set-progress-pulse-step" title="gtk_entry_set_progress_pulse_step ()"><code class="function">gtk_entry_set_progress_pulse_step()</code></a>.</p>
<div class="refsect3">
<a name="gtk-entry-get-progress-pulse-step.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-progress-pulse-step.returns"></a><h4>Returns</h4>
<p> a fraction from 0.0 to 1.0</p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-progress-pulse"></a><h3>gtk_entry_progress_pulse ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_progress_pulse (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Indicates that some progress is made, but you don’t know how much.
Causes the entry’s progress indicator to enter “activity mode,”
where a block bounces back and forth. Each call to
<a class="link" href="GtkEntry.html#gtk-entry-progress-pulse" title="gtk_entry_progress_pulse ()"><code class="function">gtk_entry_progress_pulse()</code></a> causes the block to move by a little bit
(the amount of movement per pulse is determined by
<a class="link" href="GtkEntry.html#gtk-entry-set-progress-pulse-step" title="gtk_entry_set_progress_pulse_step ()"><code class="function">gtk_entry_set_progress_pulse_step()</code></a>).</p>
<div class="refsect3">
<a name="gtk-entry-progress-pulse.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-im-context-filter-keypress"></a><h3>gtk_entry_im_context_filter_keypress ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_entry_im_context_filter_keypress (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                                      <em class="parameter"><code><span class="type">GdkEventKey</span> *event</code></em>);</pre>
<p>Allow the <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> input method to internally handle key press
and release events. If this function returns <code class="literal">TRUE</code>, then no further
processing should be done for this key event. See
<a class="link" href="GtkIMContext.html#gtk-im-context-filter-keypress" title="gtk_im_context_filter_keypress ()"><code class="function">gtk_im_context_filter_keypress()</code></a>.</p>
<p>Note that you are expected to call this function from your handler
when overriding key event handling. This is needed in the case when
you need to insert your own key handling between the input method
and the default key event handling of the <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>.
See <a class="link" href="GtkTextView.html#gtk-text-view-reset-im-context" title="gtk_text_view_reset_im_context ()"><code class="function">gtk_text_view_reset_im_context()</code></a> for an example of use.</p>
<div class="refsect3">
<a name="gtk-entry-im-context-filter-keypress.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>event</p></td>
<td class="parameter_description"><p>the key event. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gdk.EventKey]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-im-context-filter-keypress.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the input method handled the key event.</p>
</div>
<p class="since">Since: 2.22</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-reset-im-context"></a><h3>gtk_entry_reset_im_context ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_reset_im_context (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Reset the input method context of the entry if needed.</p>
<p>This can be necessary in the case where modifying the buffer
would confuse on-going input method behavior.</p>
<div class="refsect3">
<a name="gtk-entry-reset-im-context.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: 2.22</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-tabs"></a><h3>gtk_entry_get_tabs ()</h3>
<pre class="programlisting"><span class="returnvalue">PangoTabArray</span> *
gtk_entry_get_tabs (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Gets the tabstops that were set on the entry using <a class="link" href="GtkEntry.html#gtk-entry-set-tabs" title="gtk_entry_set_tabs ()"><code class="function">gtk_entry_set_tabs()</code></a>, if
any.</p>
<div class="refsect3">
<a name="gtk-entry-get-tabs.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-tabs.returns"></a><h4>Returns</h4>
<p>the tabstops, or <code class="literal">NULL</code> if none was set. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-10.html#api-index-3.10">3.10</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-tabs"></a><h3>gtk_entry_set_tabs ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_tabs (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                    <em class="parameter"><code><span class="type">PangoTabArray</span> *tabs</code></em>);</pre>
<p>Sets a <span class="type">PangoTabArray</span>; the tabstops in the array are applied to the entry
text.</p>
<div class="refsect3">
<a name="gtk-entry-set-tabs.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tabs</p></td>
<td class="parameter_description"><p>a <span class="type">PangoTabArray</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-10.html#api-index-3.10">3.10</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-icon-from-pixbuf"></a><h3>gtk_entry_set_icon_from_pixbuf ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_icon_from_pixbuf (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                                <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>,
                                <em class="parameter"><code><span class="type">GdkPixbuf</span> *pixbuf</code></em>);</pre>
<p>Sets the icon shown in the specified position using a pixbuf.</p>
<p>If <em class="parameter"><code>pixbuf</code></em>
 is <code class="literal">NULL</code>, no icon will be shown in the specified position.</p>
<div class="refsect3">
<a name="gtk-entry-set-icon-from-pixbuf.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_pos</p></td>
<td class="parameter_description"><p>Icon position</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>pixbuf</p></td>
<td class="parameter_description"><p>A <span class="type">GdkPixbuf</span>, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-icon-from-stock"></a><h3>gtk_entry_set_icon_from_stock ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_icon_from_stock (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                               <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>,
                               <em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_entry_set_icon_from_stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkEntry.html#gtk-entry-set-icon-from-icon-name" title="gtk_entry_set_icon_from_icon_name ()"><code class="function">gtk_entry_set_icon_from_icon_name()</code></a> instead.</p>
</div>
<p>Sets the icon shown in the entry at the specified position from
a stock image.</p>
<p>If <em class="parameter"><code>stock_id</code></em>
 is <code class="literal">NULL</code>, no icon will be shown in the specified position.</p>
<div class="refsect3">
<a name="gtk-entry-set-icon-from-stock.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_pos</p></td>
<td class="parameter_description"><p>Icon position</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>stock_id</p></td>
<td class="parameter_description"><p>The name of the stock item, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-icon-from-icon-name"></a><h3>gtk_entry_set_icon_from_icon_name ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_icon_from_icon_name (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                                   <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>,
                                   <em class="parameter"><code>const <span class="type">gchar</span> *icon_name</code></em>);</pre>
<p>Sets the icon shown in the entry at the specified position
from the current icon theme.</p>
<p>If the icon name isn’t known, a “broken image” icon will be displayed
instead.</p>
<p>If <em class="parameter"><code>icon_name</code></em>
 is <code class="literal">NULL</code>, no icon will be shown in the specified position.</p>
<div class="refsect3">
<a name="gtk-entry-set-icon-from-icon-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_pos</p></td>
<td class="parameter_description"><p>The position at which to set the icon</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_name</p></td>
<td class="parameter_description"><p>An icon name, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-icon-from-gicon"></a><h3>gtk_entry_set_icon_from_gicon ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_icon_from_gicon (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                               <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>,
                               <em class="parameter"><code><span class="type">GIcon</span> *icon</code></em>);</pre>
<p>Sets the icon shown in the entry at the specified position
from the current icon theme.
If the icon isn’t known, a “broken image” icon will be displayed
instead.</p>
<p>If <em class="parameter"><code>icon</code></em>
 is <code class="literal">NULL</code>, no icon will be shown in the specified position.</p>
<div class="refsect3">
<a name="gtk-entry-set-icon-from-gicon.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_pos</p></td>
<td class="parameter_description"><p>The position at which to set the icon</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon</p></td>
<td class="parameter_description"><p>The icon to set, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-icon-storage-type"></a><h3>gtk_entry_get_icon_storage_type ()</h3>
<pre class="programlisting"><a class="link" href="GtkImage.html#GtkImageType" title="enum GtkImageType"><span class="returnvalue">GtkImageType</span></a>
gtk_entry_get_icon_storage_type (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                                 <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>);</pre>
<p>Gets the type of representation being used by the icon
to store image data. If the icon has no image data,
the return value will be <a class="link" href="GtkImage.html#GTK-IMAGE-EMPTY:CAPS"><code class="literal">GTK_IMAGE_EMPTY</code></a>.</p>
<div class="refsect3">
<a name="gtk-entry-get-icon-storage-type.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_pos</p></td>
<td class="parameter_description"><p>Icon position</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-icon-storage-type.returns"></a><h4>Returns</h4>
<p> image representation being used</p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-icon-pixbuf"></a><h3>gtk_entry_get_icon_pixbuf ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkPixbuf</span> *
gtk_entry_get_icon_pixbuf (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                           <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>);</pre>
<p>Retrieves the image used for the icon.</p>
<p>Unlike the other methods of setting and getting icon data, this
method will work regardless of whether the icon was set using a
<span class="type">GdkPixbuf</span>, a <span class="type">GIcon</span>, a stock item, or an icon name.</p>
<div class="refsect3">
<a name="gtk-entry-get-icon-pixbuf.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_pos</p></td>
<td class="parameter_description"><p>Icon position</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-icon-pixbuf.returns"></a><h4>Returns</h4>
<p>A <span class="type">GdkPixbuf</span>, or <code class="literal">NULL</code> if no icon is
set for this position. </p>
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-icon-stock"></a><h3>gtk_entry_get_icon_stock ()</h3>
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_entry_get_icon_stock (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                          <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_entry_get_icon_stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkEntry.html#gtk-entry-get-icon-name" title="gtk_entry_get_icon_name ()"><code class="function">gtk_entry_get_icon_name()</code></a> instead.</p>
</div>
<p>Retrieves the stock id used for the icon, or <code class="literal">NULL</code> if there is
no icon or if the icon was set by some other method (e.g., by
pixbuf, icon name or gicon).</p>
<div class="refsect3">
<a name="gtk-entry-get-icon-stock.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_pos</p></td>
<td class="parameter_description"><p>Icon position</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-icon-stock.returns"></a><h4>Returns</h4>
<p> A stock id, or <code class="literal">NULL</code> if no icon is set or if the icon
wasn’t set from a stock id</p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-icon-name"></a><h3>gtk_entry_get_icon_name ()</h3>
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_entry_get_icon_name (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                         <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>);</pre>
<p>Retrieves the icon name used for the icon, or <code class="literal">NULL</code> if there is
no icon or if the icon was set by some other method (e.g., by
pixbuf, stock or gicon).</p>
<div class="refsect3">
<a name="gtk-entry-get-icon-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_pos</p></td>
<td class="parameter_description"><p>Icon position</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-icon-name.returns"></a><h4>Returns</h4>
<p>An icon name, or <code class="literal">NULL</code> if no icon is set or if the icon
wasn’t set from an icon name. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-icon-gicon"></a><h3>gtk_entry_get_icon_gicon ()</h3>
<pre class="programlisting"><span class="returnvalue">GIcon</span> *
gtk_entry_get_icon_gicon (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                          <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>);</pre>
<p>Retrieves the <span class="type">GIcon</span> used for the icon, or <code class="literal">NULL</code> if there is
no icon or if the icon was set by some other method (e.g., by
stock, pixbuf, or icon name).</p>
<div class="refsect3">
<a name="gtk-entry-get-icon-gicon.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_pos</p></td>
<td class="parameter_description"><p>Icon position</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-icon-gicon.returns"></a><h4>Returns</h4>
<p>A <span class="type">GIcon</span>, or <code class="literal">NULL</code> if no icon is set
or if the icon is not a <span class="type">GIcon</span>. </p>
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-icon-activatable"></a><h3>gtk_entry_set_icon_activatable ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_icon_activatable (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                                <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>,
                                <em class="parameter"><code><span class="type">gboolean</span> activatable</code></em>);</pre>
<p>Sets whether the icon is activatable.</p>
<div class="refsect3">
<a name="gtk-entry-set-icon-activatable.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_pos</p></td>
<td class="parameter_description"><p>Icon position</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>activatable</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> if the icon should be activatable</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-icon-activatable"></a><h3>gtk_entry_get_icon_activatable ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_entry_get_icon_activatable (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                                <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>);</pre>
<p>Returns whether the icon is activatable.</p>
<div class="refsect3">
<a name="gtk-entry-get-icon-activatable.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_pos</p></td>
<td class="parameter_description"><p>Icon position</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-icon-activatable.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the icon is activatable.</p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-icon-sensitive"></a><h3>gtk_entry_set_icon_sensitive ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_icon_sensitive (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                              <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>,
                              <em class="parameter"><code><span class="type">gboolean</span> sensitive</code></em>);</pre>
<p>Sets the sensitivity for the specified icon.</p>
<div class="refsect3">
<a name="gtk-entry-set-icon-sensitive.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_pos</p></td>
<td class="parameter_description"><p>Icon position</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>sensitive</p></td>
<td class="parameter_description"><p>Specifies whether the icon should appear
sensitive or insensitive</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-icon-sensitive"></a><h3>gtk_entry_get_icon_sensitive ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_entry_get_icon_sensitive (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                              <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>);</pre>
<p>Returns whether the icon appears sensitive or insensitive.</p>
<div class="refsect3">
<a name="gtk-entry-get-icon-sensitive.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_pos</p></td>
<td class="parameter_description"><p>Icon position</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-icon-sensitive.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the icon is sensitive.</p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-icon-at-pos"></a><h3>gtk_entry_get_icon_at_pos ()</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
gtk_entry_get_icon_at_pos (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                           <em class="parameter"><code><span class="type">gint</span> x</code></em>,
                           <em class="parameter"><code><span class="type">gint</span> y</code></em>);</pre>
<p>Finds the icon at the given position and return its index. The
position’s coordinates are relative to the <em class="parameter"><code>entry</code></em>
’s top left corner.
If <em class="parameter"><code>x</code></em>
, <em class="parameter"><code>y</code></em>
 doesn’t lie inside an icon, -1 is returned.
This function is intended for use in a <a class="link" href="GtkWidget.html#GtkWidget-query-tooltip" title="The “query-tooltip” signal"><span class="type">“query-tooltip”</span></a>
signal handler.</p>
<div class="refsect3">
<a name="gtk-entry-get-icon-at-pos.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>x</p></td>
<td class="parameter_description"><p>the x coordinate of the position to find</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>y</p></td>
<td class="parameter_description"><p>the y coordinate of the position to find</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-icon-at-pos.returns"></a><h4>Returns</h4>
<p> the index of the icon at the given position, or -1</p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-icon-tooltip-text"></a><h3>gtk_entry_set_icon_tooltip_text ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_icon_tooltip_text (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                                 <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>,
                                 <em class="parameter"><code>const <span class="type">gchar</span> *tooltip</code></em>);</pre>
<p>Sets <em class="parameter"><code>tooltip</code></em>
 as the contents of the tooltip for the icon
at the specified position.</p>
<p>Use <code class="literal">NULL</code> for <em class="parameter"><code>tooltip</code></em>
 to remove an existing tooltip.</p>
<p>See also <a class="link" href="GtkWidget.html#gtk-widget-set-tooltip-text" title="gtk_widget_set_tooltip_text ()"><code class="function">gtk_widget_set_tooltip_text()</code></a> and 
<a class="link" href="GtkEntry.html#gtk-entry-set-icon-tooltip-markup" title="gtk_entry_set_icon_tooltip_markup ()"><code class="function">gtk_entry_set_icon_tooltip_markup()</code></a>.</p>
<p>If you unset the widget tooltip via <a class="link" href="GtkWidget.html#gtk-widget-set-tooltip-text" title="gtk_widget_set_tooltip_text ()"><code class="function">gtk_widget_set_tooltip_text()</code></a> or
<a class="link" href="GtkWidget.html#gtk-widget-set-tooltip-markup" title="gtk_widget_set_tooltip_markup ()"><code class="function">gtk_widget_set_tooltip_markup()</code></a>, this sets GtkWidget:has-tooltip to <code class="literal">FALSE</code>,
which suppresses icon tooltips too. You can resolve this by then calling
<a class="link" href="GtkWidget.html#gtk-widget-set-has-tooltip" title="gtk_widget_set_has_tooltip ()"><code class="function">gtk_widget_set_has_tooltip()</code></a> to set GtkWidget:has-tooltip back to <code class="literal">TRUE</code>, or
setting at least one non-empty tooltip on any icon achieves the same result.</p>
<div class="refsect3">
<a name="gtk-entry-set-icon-tooltip-text.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_pos</p></td>
<td class="parameter_description"><p>the icon position</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tooltip</p></td>
<td class="parameter_description"><p>the contents of the tooltip for the icon, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-icon-tooltip-text"></a><h3>gtk_entry_get_icon_tooltip_text ()</h3>
<pre class="programlisting"><span class="returnvalue">gchar</span> *
gtk_entry_get_icon_tooltip_text (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                                 <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>);</pre>
<p>Gets the contents of the tooltip on the icon at the specified 
position in <em class="parameter"><code>entry</code></em>
.</p>
<div class="refsect3">
<a name="gtk-entry-get-icon-tooltip-text.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_pos</p></td>
<td class="parameter_description"><p>the icon position</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-icon-tooltip-text.returns"></a><h4>Returns</h4>
<p>the tooltip text, or <code class="literal">NULL</code>. Free the returned
string with <code class="function">g_free()</code> when done. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-icon-tooltip-markup"></a><h3>gtk_entry_set_icon_tooltip_markup ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_icon_tooltip_markup (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                                   <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>,
                                   <em class="parameter"><code>const <span class="type">gchar</span> *tooltip</code></em>);</pre>
<p>Sets <em class="parameter"><code>tooltip</code></em>
 as the contents of the tooltip for the icon at
the specified position. <em class="parameter"><code>tooltip</code></em>
 is assumed to be marked up with
the Pango text markup language.</p>
<p>Use <code class="literal">NULL</code> for <em class="parameter"><code>tooltip</code></em>
 to remove an existing tooltip.</p>
<p>See also <a class="link" href="GtkWidget.html#gtk-widget-set-tooltip-markup" title="gtk_widget_set_tooltip_markup ()"><code class="function">gtk_widget_set_tooltip_markup()</code></a> and 
<a class="link" href="GtkEntry.html#gtk-entry-set-icon-tooltip-text" title="gtk_entry_set_icon_tooltip_text ()"><code class="function">gtk_entry_set_icon_tooltip_text()</code></a>.</p>
<div class="refsect3">
<a name="gtk-entry-set-icon-tooltip-markup.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_pos</p></td>
<td class="parameter_description"><p>the icon position</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tooltip</p></td>
<td class="parameter_description"><p>the contents of the tooltip for the icon, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-icon-tooltip-markup"></a><h3>gtk_entry_get_icon_tooltip_markup ()</h3>
<pre class="programlisting"><span class="returnvalue">gchar</span> *
gtk_entry_get_icon_tooltip_markup (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                                   <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>);</pre>
<p>Gets the contents of the tooltip on the icon at the specified 
position in <em class="parameter"><code>entry</code></em>
.</p>
<div class="refsect3">
<a name="gtk-entry-get-icon-tooltip-markup.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_pos</p></td>
<td class="parameter_description"><p>the icon position</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-icon-tooltip-markup.returns"></a><h4>Returns</h4>
<p>the tooltip text, or <code class="literal">NULL</code>. Free the returned
string with <code class="function">g_free()</code> when done. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-icon-drag-source"></a><h3>gtk_entry_set_icon_drag_source ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_icon_drag_source (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                                <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>,
                                <em class="parameter"><code><a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> *target_list</code></em>,
                                <em class="parameter"><code><span class="type">GdkDragAction</span> actions</code></em>);</pre>
<p>Sets up the icon at the given position so that GTK+ will start a drag
operation when the user clicks and drags the icon.</p>
<p>To handle the drag operation, you need to connect to the usual
<a class="link" href="GtkWidget.html#GtkWidget-drag-data-get" title="The “drag-data-get” signal"><span class="type">“drag-data-get”</span></a> (or possibly <a class="link" href="GtkWidget.html#GtkWidget-drag-data-delete" title="The “drag-data-delete” signal"><span class="type">“drag-data-delete”</span></a>)
signal, and use <a class="link" href="GtkEntry.html#gtk-entry-get-current-icon-drag-source" title="gtk_entry_get_current_icon_drag_source ()"><code class="function">gtk_entry_get_current_icon_drag_source()</code></a> in
your signal handler to find out if the drag was started from
an icon.</p>
<p>By default, GTK+ uses the icon as the drag icon. You can use the 
<a class="link" href="GtkWidget.html#GtkWidget-drag-begin" title="The “drag-begin” signal"><span class="type">“drag-begin”</span></a> signal to set a different icon. Note that you 
have to use <code class="function">g_signal_connect_after()</code> to ensure that your signal handler
gets executed after the default handler.</p>
<div class="refsect3">
<a name="gtk-entry-set-icon-drag-source.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_pos</p></td>
<td class="parameter_description"><p>icon position</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>target_list</p></td>
<td class="parameter_description"><p>the targets (data formats) in which the data can be provided</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>actions</p></td>
<td class="parameter_description"><p>a bitmask of the allowed drag actions</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-current-icon-drag-source"></a><h3>gtk_entry_get_current_icon_drag_source ()</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
gtk_entry_get_current_icon_drag_source
                               (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Returns the index of the icon which is the source of the current
DND operation, or -1.</p>
<p>This function is meant to be used in a <a class="link" href="GtkWidget.html#GtkWidget-drag-data-get" title="The “drag-data-get” signal"><span class="type">“drag-data-get”</span></a>
callback.</p>
<div class="refsect3">
<a name="gtk-entry-get-current-icon-drag-source.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-entry-get-current-icon-drag-source.returns"></a><h4>Returns</h4>
<p> index of the icon which is the source of the current
DND operation, or -1.</p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-icon-area"></a><h3>gtk_entry_get_icon_area ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_get_icon_area (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                         <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos</code></em>,
                         <em class="parameter"><code><span class="type">GdkRectangle</span> *icon_area</code></em>);</pre>
<p>Gets the area where entry’s icon at <em class="parameter"><code>icon_pos</code></em>
 is drawn.
This function is useful when drawing something to the
entry in a draw callback.</p>
<p>If the entry is not realized or has no icon at the given position,
<em class="parameter"><code>icon_area</code></em>
 is filled with zeros. Otherwise, <em class="parameter"><code>icon_area</code></em>
 will be filled
with the icon’s allocation, relative to <em class="parameter"><code>entry</code></em>
’s allocation.</p>
<p>See also <a class="link" href="GtkEntry.html#gtk-entry-get-text-area" title="gtk_entry_get_text_area ()"><code class="function">gtk_entry_get_text_area()</code></a></p>
<div class="refsect3">
<a name="gtk-entry-get-icon-area.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>A <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_pos</p></td>
<td class="parameter_description"><p>Icon position</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_area</p></td>
<td class="parameter_description"><p>Return location for the icon’s area. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-input-purpose"></a><h3>gtk_entry_set_input_purpose ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_input_purpose (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                             <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkInputPurpose" title="enum GtkInputPurpose"><span class="type">GtkInputPurpose</span></a> purpose</code></em>);</pre>
<p>Sets the <a class="link" href="GtkEntry.html#GtkEntry--input-purpose" title="The “input-purpose” property"><span class="type">“input-purpose”</span></a> property which
can be used by on-screen keyboards and other input
methods to adjust their behaviour.</p>
<div class="refsect3">
<a name="gtk-entry-set-input-purpose.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>purpose</p></td>
<td class="parameter_description"><p>the purpose</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-input-purpose"></a><h3>gtk_entry_get_input_purpose ()</h3>
<pre class="programlisting"><a class="link" href="GtkEntry.html#GtkInputPurpose" title="enum GtkInputPurpose"><span class="returnvalue">GtkInputPurpose</span></a>
gtk_entry_get_input_purpose (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Gets the value of the <a class="link" href="GtkEntry.html#GtkEntry--input-purpose" title="The “input-purpose” property"><span class="type">“input-purpose”</span></a> property.</p>
<div class="refsect3">
<a name="gtk-entry-get-input-purpose.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-set-input-hints"></a><h3>gtk_entry_set_input_hints ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_set_input_hints (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>,
                           <em class="parameter"><code><a class="link" href="GtkEntry.html#GtkInputHints" title="enum GtkInputHints"><span class="type">GtkInputHints</span></a> hints</code></em>);</pre>
<p>Sets the <a class="link" href="GtkEntry.html#GtkEntry--input-hints" title="The “input-hints” property"><span class="type">“input-hints”</span></a> property, which
allows input methods to fine-tune their behaviour.</p>
<div class="refsect3">
<a name="gtk-entry-set-input-hints.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>hints</p></td>
<td class="parameter_description"><p>the hints</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-get-input-hints"></a><h3>gtk_entry_get_input_hints ()</h3>
<pre class="programlisting"><a class="link" href="GtkEntry.html#GtkInputHints" title="enum GtkInputHints"><span class="returnvalue">GtkInputHints</span></a>
gtk_entry_get_input_hints (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Gets the value of the <a class="link" href="GtkEntry.html#GtkEntry--input-hints" title="The “input-hints” property"><span class="type">“input-hints”</span></a> property.</p>
<div class="refsect3">
<a name="gtk-entry-get-input-hints.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-entry-grab-focus-without-selecting"></a><h3>gtk_entry_grab_focus_without_selecting ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_entry_grab_focus_without_selecting
                               (<em class="parameter"><code><a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry</code></em>);</pre>
<p>Causes <em class="parameter"><code>entry</code></em>
 to have keyboard focus.</p>
<p>It behaves like <a class="link" href="GtkWidget.html#gtk-widget-grab-focus" title="gtk_widget_grab_focus ()"><code class="function">gtk_widget_grab_focus()</code></a>,
except that it doesn't select the contents of the entry.
You only want to call this on some special entries
which the user usually doesn't want to replace all text in,
such as search-as-you-type entries.</p>
<div class="refsect3">
<a name="gtk-entry-grab-focus-without-selecting.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-16.html#api-index-3.16">3.16</a></p>
</div>
</div>
<div class="refsect1">
<a name="GtkEntry.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GtkEntry-struct"></a><h3>struct GtkEntry</h3>
<pre class="programlisting">struct GtkEntry;</pre>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntryClass"></a><h3>struct GtkEntryClass</h3>
<pre class="programlisting">struct GtkEntryClass {
  GtkWidgetClass parent_class;

  /* Hook to customize right-click popup */
  void (* populate_popup)   (GtkEntry       *entry,
                             GtkWidget      *popup);

  /* Action signals
   */
  void (* activate)           (GtkEntry             *entry);
  void (* move_cursor)        (GtkEntry             *entry,
			       GtkMovementStep       step,
			       gint                  count,
			       gboolean              extend_selection);
  void (* insert_at_cursor)   (GtkEntry             *entry,
			       const gchar          *str);
  void (* delete_from_cursor) (GtkEntry             *entry,
			       GtkDeleteType         type,
			       gint                  count);
  void (* backspace)          (GtkEntry             *entry);
  void (* cut_clipboard)      (GtkEntry             *entry);
  void (* copy_clipboard)     (GtkEntry             *entry);
  void (* paste_clipboard)    (GtkEntry             *entry);
  void (* toggle_overwrite)   (GtkEntry             *entry);

  /* hooks to add other objects beside the entry (like in GtkSpinButton) */
  void (* get_text_area_size) (GtkEntry       *entry,
			       gint           *x,
			       gint           *y,
			       gint           *width,
			       gint           *height);
  void (* get_frame_size)     (GtkEntry       *entry,
                               gint           *x,
                               gint           *y,
			       gint           *width,
			       gint           *height);
  void (* insert_emoji)       (GtkEntry             *entry);
};
</pre>
<p>Class structure for <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>. All virtual functions have a default
implementation. Derived classes may set the virtual function pointers for the
signal handlers to <code class="literal">NULL</code>, but must keep <em class="parameter"><code>get_text_area_size</code></em>
 and
<em class="parameter"><code>get_frame_size</code></em>
 non-<code class="literal">NULL</code>; either use the default implementation, or provide
a custom one.</p>
<div class="refsect3">
<a name="GtkEntryClass.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.populate-popup"></a>populate_popup</code></em> ()</p></td>
<td class="struct_member_description"><p>Class handler for the <a class="link" href="GtkEntry.html#GtkEntry-populate-popup" title="The “populate-popup” signal"><span class="type">“populate-popup”</span></a> signal. If
non-<code class="literal">NULL</code>, this will be called to add additional entries to the context
menu when it is displayed.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.activate"></a>activate</code></em> ()</p></td>
<td class="struct_member_description"><p>Class handler for the <a class="link" href="GtkEntry.html#GtkEntry-activate" title="The “activate” signal"><span class="type">“activate”</span></a> signal. The default
implementation calls <a class="link" href="GtkWindow.html#gtk-window-activate-default" title="gtk_window_activate_default ()"><code class="function">gtk_window_activate_default()</code></a> on the entry’s top-level
window.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.move-cursor"></a>move_cursor</code></em> ()</p></td>
<td class="struct_member_description"><p>Class handler for the <a class="link" href="GtkEntry.html#GtkEntry-move-cursor" title="The “move-cursor” signal"><span class="type">“move-cursor”</span></a> signal. The
default implementation specifies the standard <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> cursor movement
behavior.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.insert-at-cursor"></a>insert_at_cursor</code></em> ()</p></td>
<td class="struct_member_description"><p>Class handler for the <a class="link" href="GtkEntry.html#GtkEntry-insert-at-cursor" title="The “insert-at-cursor” signal"><span class="type">“insert-at-cursor”</span></a> signal.
The default implementation inserts text at the cursor.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.delete-from-cursor"></a>delete_from_cursor</code></em> ()</p></td>
<td class="struct_member_description"><p>Class handler for the <a class="link" href="GtkEntry.html#GtkEntry-delete-from-cursor" title="The “delete-from-cursor” signal"><span class="type">“delete-from-cursor”</span></a>
signal. The default implementation deletes the selection or the specified
number of characters or words.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.backspace"></a>backspace</code></em> ()</p></td>
<td class="struct_member_description"><p>Class handler for the <a class="link" href="GtkEntry.html#GtkEntry-backspace" title="The “backspace” signal"><span class="type">“backspace”</span></a> signal. The default
implementation deletes the selection or a single character or word.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.cut-clipboard"></a>cut_clipboard</code></em> ()</p></td>
<td class="struct_member_description"><p>Class handler for the <a class="link" href="GtkEntry.html#GtkEntry-cut-clipboard" title="The “cut-clipboard” signal"><span class="type">“cut-clipboard”</span></a> signal. The
default implementation cuts the selection, if one exists.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.copy-clipboard"></a>copy_clipboard</code></em> ()</p></td>
<td class="struct_member_description"><p>Class handler for the <a class="link" href="GtkEntry.html#GtkEntry-copy-clipboard" title="The “copy-clipboard” signal"><span class="type">“copy-clipboard”</span></a> signal. The
default implementation copies the selection, if one exists.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.paste-clipboard"></a>paste_clipboard</code></em> ()</p></td>
<td class="struct_member_description"><p>Class handler for the <a class="link" href="GtkEntry.html#GtkEntry-paste-clipboard" title="The “paste-clipboard” signal"><span class="type">“paste-clipboard”</span></a> signal.
The default implementation pastes at the current cursor position or over
the current selection if one exists.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.toggle-overwrite"></a>toggle_overwrite</code></em> ()</p></td>
<td class="struct_member_description"><p>Class handler for the <a class="link" href="GtkEntry.html#GtkEntry-toggle-overwrite" title="The “toggle-overwrite” signal"><span class="type">“toggle-overwrite”</span></a> signal.
The default implementation toggles overwrite mode and blinks the cursor.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.get-text-area-size"></a>get_text_area_size</code></em> ()</p></td>
<td class="struct_member_description"><p>Calculate the size of the text area, which is its
allocated width and requested height, minus space for margins and borders.
This virtual function must be non-<code class="literal">NULL</code>.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.get-frame-size"></a>get_frame_size</code></em> ()</p></td>
<td class="struct_member_description"><p>Calculate the size of the text area frame, which is its
allocated width and requested height, minus space for margins and borders,
and taking baseline and text height into account. This virtual function
must be non-<code class="literal">NULL</code>.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkEntryClass.insert-emoji"></a>insert_emoji</code></em> ()</p></td>
<td> </td>
<td> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntryIconPosition"></a><h3>enum GtkEntryIconPosition</h3>
<p>Specifies the side of the entry at which an icon is placed.</p>
<div class="refsect3">
<a name="GtkEntryIconPosition.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="GTK-ENTRY-ICON-PRIMARY:CAPS"></a>GTK_ENTRY_ICON_PRIMARY</p></td>
<td class="enum_member_description">
<p>At the beginning of the entry (depending on the text direction).</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-ENTRY-ICON-SECONDARY:CAPS"></a>GTK_ENTRY_ICON_SECONDARY</p></td>
<td class="enum_member_description">
<p>At the end of the entry (depending on the text direction).</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkInputPurpose"></a><h3>enum GtkInputPurpose</h3>
<p>Describes primary purpose of the input widget. This information is
useful for on-screen keyboards and similar input methods to decide
which keys should be presented to the user.</p>
<p>Note that the purpose is not meant to impose a totally strict rule
about allowed characters, and does not replace input validation.
It is fine for an on-screen keyboard to let the user override the
character set restriction that is expressed by the purpose. The
application is expected to validate the entry contents, even if
it specified a purpose.</p>
<p>The difference between <em class="parameter"><code>GTK_INPUT_PURPOSE_DIGITS</code></em>
 and
<em class="parameter"><code>GTK_INPUT_PURPOSE_NUMBER</code></em>
 is that the former accepts only digits
while the latter also some punctuation (like commas or points, plus,
minus) and “e” or “E” as in 3.14E+000.</p>
<p>This enumeration may be extended in the future; input methods should
interpret unknown values as “free form”.</p>
<div class="refsect3">
<a name="GtkInputPurpose.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-FREE-FORM:CAPS"></a>GTK_INPUT_PURPOSE_FREE_FORM</p></td>
<td class="enum_member_description">
<p>Allow any character</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-ALPHA:CAPS"></a>GTK_INPUT_PURPOSE_ALPHA</p></td>
<td class="enum_member_description">
<p>Allow only alphabetic characters</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-DIGITS:CAPS"></a>GTK_INPUT_PURPOSE_DIGITS</p></td>
<td class="enum_member_description">
<p>Allow only digits</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-NUMBER:CAPS"></a>GTK_INPUT_PURPOSE_NUMBER</p></td>
<td class="enum_member_description">
<p>Edited field expects numbers</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-PHONE:CAPS"></a>GTK_INPUT_PURPOSE_PHONE</p></td>
<td class="enum_member_description">
<p>Edited field expects phone number</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-URL:CAPS"></a>GTK_INPUT_PURPOSE_URL</p></td>
<td class="enum_member_description">
<p>Edited field expects URL</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-EMAIL:CAPS"></a>GTK_INPUT_PURPOSE_EMAIL</p></td>
<td class="enum_member_description">
<p>Edited field expects email address</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-NAME:CAPS"></a>GTK_INPUT_PURPOSE_NAME</p></td>
<td class="enum_member_description">
<p>Edited field expects the name of a person</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-PASSWORD:CAPS"></a>GTK_INPUT_PURPOSE_PASSWORD</p></td>
<td class="enum_member_description">
<p>Like <em class="parameter"><code>GTK_INPUT_PURPOSE_FREE_FORM</code></em>
, but characters are hidden</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-PIN:CAPS"></a>GTK_INPUT_PURPOSE_PIN</p></td>
<td class="enum_member_description">
<p>Like <em class="parameter"><code>GTK_INPUT_PURPOSE_DIGITS</code></em>
, but characters are hidden</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-PURPOSE-TERMINAL:CAPS"></a>GTK_INPUT_PURPOSE_TERMINAL</p></td>
<td class="enum_member_description">
<p>Allow any character, in addition to control codes</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkInputHints"></a><h3>enum GtkInputHints</h3>
<p>Describes hints that might be taken into account by input methods
or applications. Note that input methods may already tailor their
behaviour according to the <a class="link" href="GtkEntry.html#GtkInputPurpose" title="enum GtkInputPurpose"><span class="type">GtkInputPurpose</span></a> of the entry.</p>
<p>Some common sense is expected when using these flags - mixing
<em class="parameter"><code>GTK_INPUT_HINT_LOWERCASE</code></em>
 with any of the uppercase hints makes no sense.</p>
<p>This enumeration may be extended in the future; input methods should
ignore unknown values.</p>
<div class="refsect3">
<a name="GtkInputHints.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-NONE:CAPS"></a>GTK_INPUT_HINT_NONE</p></td>
<td class="enum_member_description">
<p>No special behaviour suggested</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-SPELLCHECK:CAPS"></a>GTK_INPUT_HINT_SPELLCHECK</p></td>
<td class="enum_member_description">
<p>Suggest checking for typos</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-NO-SPELLCHECK:CAPS"></a>GTK_INPUT_HINT_NO_SPELLCHECK</p></td>
<td class="enum_member_description">
<p>Suggest not checking for typos</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-WORD-COMPLETION:CAPS"></a>GTK_INPUT_HINT_WORD_COMPLETION</p></td>
<td class="enum_member_description">
<p>Suggest word completion</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-LOWERCASE:CAPS"></a>GTK_INPUT_HINT_LOWERCASE</p></td>
<td class="enum_member_description">
<p>Suggest to convert all text to lowercase</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-UPPERCASE-CHARS:CAPS"></a>GTK_INPUT_HINT_UPPERCASE_CHARS</p></td>
<td class="enum_member_description">
<p>Suggest to capitalize all text</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-UPPERCASE-WORDS:CAPS"></a>GTK_INPUT_HINT_UPPERCASE_WORDS</p></td>
<td class="enum_member_description">
<p>Suggest to capitalize the first
character of each word</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-UPPERCASE-SENTENCES:CAPS"></a>GTK_INPUT_HINT_UPPERCASE_SENTENCES</p></td>
<td class="enum_member_description">
<p>Suggest to capitalize the
first word of each sentence</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-INHIBIT-OSK:CAPS"></a>GTK_INPUT_HINT_INHIBIT_OSK</p></td>
<td class="enum_member_description">
<p>Suggest to not show an onscreen keyboard
(e.g for a calculator that already has all the keys).</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-VERTICAL-WRITING:CAPS"></a>GTK_INPUT_HINT_VERTICAL_WRITING</p></td>
<td class="enum_member_description">
<p>The text is vertical. Since 3.18</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-EMOJI:CAPS"></a>GTK_INPUT_HINT_EMOJI</p></td>
<td class="enum_member_description">
<p>Suggest offering Emoji support. Since 3.22.20</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-INPUT-HINT-NO-EMOJI:CAPS"></a>GTK_INPUT_HINT_NO_EMOJI</p></td>
<td class="enum_member_description">
<p>Suggest not offering Emoji support. Since 3.22.20</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></p>
</div>
</div>
<div class="refsect1">
<a name="GtkEntry.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkEntry--activates-default"></a><h3>The <code class="literal">“activates-default”</code> property</h3>
<pre class="programlisting">  “activates-default”        <span class="type">gboolean</span></pre>
<p>Whether to activate the default widget (such as the default button in a dialog) when Enter is pressed.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--attributes"></a><h3>The <code class="literal">“attributes”</code> property</h3>
<pre class="programlisting">  “attributes”               <span class="type">PangoAttrList</span> *</pre>
<p>A list of Pango attributes to apply to the text of the entry.</p>
<p>This is mainly useful to change the size or weight of the text.</p>
<p>The <span class="type">PangoAttribute</span>'s <em class="parameter"><code>start_index</code></em>
 and <em class="parameter"><code>end_index</code></em>
 must refer to the
<a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> text, i.e. without the preedit string.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--buffer"></a><h3>The <code class="literal">“buffer”</code> property</h3>
<pre class="programlisting">  “buffer”                   <a class="link" href="GtkEntryBuffer.html" title="GtkEntryBuffer"><span class="type">GtkEntryBuffer</span></a> *</pre>
<p>Text buffer object which actually stores entry text.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write / Construct</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--caps-lock-warning"></a><h3>The <code class="literal">“caps-lock-warning”</code> property</h3>
<pre class="programlisting">  “caps-lock-warning”        <span class="type">gboolean</span></pre>
<p>Whether password entries will show a warning when Caps Lock is on.</p>
<p>Note that the warning is shown using a secondary icon, and thus
does not work if you are using the secondary icon position for some
other purpose.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--completion"></a><h3>The <code class="literal">“completion”</code> property</h3>
<pre class="programlisting">  “completion”               <a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a> *</pre>
<p>The auxiliary completion object to use with the entry.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="api-index-3-2.html#api-index-3.2">3.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--cursor-position"></a><h3>The <code class="literal">“cursor-position”</code> property</h3>
<pre class="programlisting">  “cursor-position”          <span class="type">int</span></pre>
<p>The current position of the insertion cursor in chars.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read</p>
<p>Allowed values: [0,65535]</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--editable"></a><h3>The <code class="literal">“editable”</code> property</h3>
<pre class="programlisting">  “editable”                 <span class="type">gboolean</span></pre>
<p>Whether the entry contents can be edited.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--enable-emoji-completion"></a><h3>The <code class="literal">“enable-emoji-completion”</code> property</h3>
<pre class="programlisting">  “enable-emoji-completion”  <span class="type">gboolean</span></pre>
<p>Whether to suggest Emoji replacements.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--has-frame"></a><h3>The <code class="literal">“has-frame”</code> property</h3>
<pre class="programlisting">  “has-frame”                <span class="type">gboolean</span></pre>
<p>FALSE removes outside bevel from entry.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--im-module"></a><h3>The <code class="literal">“im-module”</code> property</h3>
<pre class="programlisting">  “im-module”                <span class="type">char</span> *</pre>
<p>Which IM (input method) module should be used for this entry.
See <a class="link" href="GtkIMContext.html" title="GtkIMContext"><span class="type">GtkIMContext</span></a>.</p>
<p>Setting this to a non-<code class="literal">NULL</code> value overrides the
system-wide IM module setting. See the GtkSettings
<a class="link" href="GtkSettings.html#GtkSettings--gtk-im-module" title="The “gtk-im-module” property"><span class="type">“gtk-im-module”</span></a> property.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--inner-border"></a><h3>The <code class="literal">“inner-border”</code> property</h3>
<pre class="programlisting">  “inner-border”             <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a> *</pre>
<p>Sets the text area's border between the text and the frame.</p>
<div class="warning">
<p><code class="literal">GtkEntry:inner-border</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>Use the standard border and padding CSS properties
  (through objects like <a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> and <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a>); the value
  of this style property is ignored.</p>
</div>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--input-hints"></a><h3>The <code class="literal">“input-hints”</code> property</h3>
<pre class="programlisting">  “input-hints”              <a class="link" href="GtkEntry.html#GtkInputHints" title="enum GtkInputHints"><span class="type">GtkInputHints</span></a></pre>
<p>Additional hints (beyond <a class="link" href="GtkEntry.html#GtkEntry--input-purpose" title="The “input-purpose” property"><span class="type">“input-purpose”</span></a>) that
allow input methods to fine-tune their behaviour.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--input-purpose"></a><h3>The <code class="literal">“input-purpose”</code> property</h3>
<pre class="programlisting">  “input-purpose”            <a class="link" href="GtkEntry.html#GtkInputPurpose" title="enum GtkInputPurpose"><span class="type">GtkInputPurpose</span></a></pre>
<p>The purpose of this text field.</p>
<p>This property can be used by on-screen keyboards and other input
methods to adjust their behaviour.</p>
<p>Note that setting the purpose to <a class="link" href="GtkEntry.html#GTK-INPUT-PURPOSE-PASSWORD:CAPS"><code class="literal">GTK_INPUT_PURPOSE_PASSWORD</code></a> or
<a class="link" href="GtkEntry.html#GTK-INPUT-PURPOSE-PIN:CAPS"><code class="literal">GTK_INPUT_PURPOSE_PIN</code></a> is independent from setting
<a class="link" href="GtkEntry.html#GtkEntry--visibility" title="The “visibility” property"><span class="type">“visibility”</span></a>.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: GTK_INPUT_PURPOSE_FREE_FORM</p>
<p class="since">Since: <a class="link" href="api-index-3-6.html#api-index-3.6">3.6</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--invisible-char"></a><h3>The <code class="literal">“invisible-char”</code> property</h3>
<pre class="programlisting">  “invisible-char”           <span class="type">guint</span></pre>
<p>The invisible character is used when masking entry contents (in
\"password mode\")"). When it is not explicitly set with the
<a class="link" href="GtkEntry.html#GtkEntry--invisible-char" title="The “invisible-char” property"><span class="type">“invisible-char”</span></a> property, GTK+ determines the character
to use from a list of possible candidates, depending on availability
in the current font.</p>
<p>This style property allows the theme to prepend a character
to the list of candidates.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: '*'</p>
<p class="since">Since: 2.18</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--invisible-char-set"></a><h3>The <code class="literal">“invisible-char-set”</code> property</h3>
<pre class="programlisting">  “invisible-char-set”       <span class="type">gboolean</span></pre>
<p>Whether the invisible char has been set for the <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--max-length"></a><h3>The <code class="literal">“max-length”</code> property</h3>
<pre class="programlisting">  “max-length”               <span class="type">int</span></pre>
<p>Maximum number of characters for this entry. Zero if no maximum.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Allowed values: [0,65535]</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--max-width-chars"></a><h3>The <code class="literal">“max-width-chars”</code> property</h3>
<pre class="programlisting">  “max-width-chars”          <span class="type">int</span></pre>
<p>The desired maximum width of the entry, in characters.
If this property is set to -1, the width will be calculated
automatically.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &gt;= -1</p>
<p>Default value: -1</p>
<p class="since">Since: <a class="link" href="api-index-3-12.html#api-index-3.12">3.12</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--overwrite-mode"></a><h3>The <code class="literal">“overwrite-mode”</code> property</h3>
<pre class="programlisting">  “overwrite-mode”           <span class="type">gboolean</span></pre>
<p>If text is overwritten when typing in the <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
<p class="since">Since: 2.14</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--placeholder-text"></a><h3>The <code class="literal">“placeholder-text”</code> property</h3>
<pre class="programlisting">  “placeholder-text”         <span class="type">char</span> *</pre>
<p>The text that will be displayed in the <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> when it is empty
and unfocused.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: <a class="link" href="api-index-3-2.html#api-index-3.2">3.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--populate-all"></a><h3>The <code class="literal">“populate-all”</code> property</h3>
<pre class="programlisting">  “populate-all”             <span class="type">gboolean</span></pre>
<p>If :populate-all is <code class="literal">TRUE</code>, the <a class="link" href="GtkEntry.html#GtkEntry-populate-popup" title="The “populate-popup” signal"><span class="type">“populate-popup”</span></a>
signal is also emitted for touch popups.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
<p class="since">Since: <a class="link" href="api-index-3-8.html#api-index-3.8">3.8</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--primary-icon-activatable"></a><h3>The <code class="literal">“primary-icon-activatable”</code> property</h3>
<pre class="programlisting">  “primary-icon-activatable” <span class="type">gboolean</span></pre>
<p>Whether the primary icon is activatable.</p>
<p>GTK+ emits the <a class="link" href="GtkEntry.html#GtkEntry-icon-press" title="The “icon-press” signal"><span class="type">“icon-press”</span></a> and <a class="link" href="GtkEntry.html#GtkEntry-icon-release" title="The “icon-release” signal"><span class="type">“icon-release”</span></a>
signals only on sensitive, activatable icons.</p>
<p>Sensitive, but non-activatable icons can be used for purely
informational purposes.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--primary-icon-gicon"></a><h3>The <code class="literal">“primary-icon-gicon”</code> property</h3>
<pre class="programlisting">  “primary-icon-gicon”       <span class="type">GIcon</span> *</pre>
<p>The <span class="type">GIcon</span> to use for the primary icon for the entry.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--primary-icon-name"></a><h3>The <code class="literal">“primary-icon-name”</code> property</h3>
<pre class="programlisting">  “primary-icon-name”        <span class="type">char</span> *</pre>
<p>The icon name to use for the primary icon for the entry.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--primary-icon-pixbuf"></a><h3>The <code class="literal">“primary-icon-pixbuf”</code> property</h3>
<pre class="programlisting">  “primary-icon-pixbuf”      <span class="type">GdkPixbuf</span> *</pre>
<p>A pixbuf to use as the primary icon for the entry.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--primary-icon-sensitive"></a><h3>The <code class="literal">“primary-icon-sensitive”</code> property</h3>
<pre class="programlisting">  “primary-icon-sensitive”   <span class="type">gboolean</span></pre>
<p>Whether the primary icon is sensitive.</p>
<p>An insensitive icon appears grayed out. GTK+ does not emit the
<a class="link" href="GtkEntry.html#GtkEntry-icon-press" title="The “icon-press” signal"><span class="type">“icon-press”</span></a> and <a class="link" href="GtkEntry.html#GtkEntry-icon-release" title="The “icon-release” signal"><span class="type">“icon-release”</span></a> signals and
does not allow DND from insensitive icons.</p>
<p>An icon should be set insensitive if the action that would trigger
when clicked is currently not available.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--primary-icon-stock"></a><h3>The <code class="literal">“primary-icon-stock”</code> property</h3>
<pre class="programlisting">  “primary-icon-stock”       <span class="type">char</span> *</pre>
<p>The stock id to use for the primary icon for the entry.</p>
<div class="warning">
<p><code class="literal">GtkEntry:primary-icon-stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkEntry.html#GtkEntry--primary-icon-name" title="The “primary-icon-name” property"><span class="type">“primary-icon-name”</span></a> instead.</p>
</div>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--primary-icon-storage-type"></a><h3>The <code class="literal">“primary-icon-storage-type”</code> property</h3>
<pre class="programlisting">  “primary-icon-storage-type” <a class="link" href="GtkImage.html#GtkImageType" title="enum GtkImageType"><span class="type">GtkImageType</span></a></pre>
<p>The representation which is used for the primary icon of the entry.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read</p>
<p>Default value: GTK_IMAGE_EMPTY</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--primary-icon-tooltip-markup"></a><h3>The <code class="literal">“primary-icon-tooltip-markup”</code> property</h3>
<pre class="programlisting">  “primary-icon-tooltip-markup” <span class="type">char</span> *</pre>
<p>The contents of the tooltip on the primary icon, which is marked up
with the Pango text markup language.</p>
<p>Also see <a class="link" href="GtkEntry.html#gtk-entry-set-icon-tooltip-markup" title="gtk_entry_set_icon_tooltip_markup ()"><code class="function">gtk_entry_set_icon_tooltip_markup()</code></a>.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--primary-icon-tooltip-text"></a><h3>The <code class="literal">“primary-icon-tooltip-text”</code> property</h3>
<pre class="programlisting">  “primary-icon-tooltip-text” <span class="type">char</span> *</pre>
<p>The contents of the tooltip on the primary icon.</p>
<p>Also see <a class="link" href="GtkEntry.html#gtk-entry-set-icon-tooltip-text" title="gtk_entry_set_icon_tooltip_text ()"><code class="function">gtk_entry_set_icon_tooltip_text()</code></a>.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--progress-fraction"></a><h3>The <code class="literal">“progress-fraction”</code> property</h3>
<pre class="programlisting">  “progress-fraction”        <span class="type">double</span></pre>
<p>The current fraction of the task that's been completed.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Allowed values: [0,1]</p>
<p>Default value: 0</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--progress-pulse-step"></a><h3>The <code class="literal">“progress-pulse-step”</code> property</h3>
<pre class="programlisting">  “progress-pulse-step”      <span class="type">double</span></pre>
<p>The fraction of total entry width to move the progress
bouncing block for each call to <a class="link" href="GtkEntry.html#gtk-entry-progress-pulse" title="gtk_entry_progress_pulse ()"><code class="function">gtk_entry_progress_pulse()</code></a>.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Allowed values: [0,1]</p>
<p>Default value: 0.1</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--scroll-offset"></a><h3>The <code class="literal">“scroll-offset”</code> property</h3>
<pre class="programlisting">  “scroll-offset”            <span class="type">int</span></pre>
<p>Number of pixels of the entry scrolled off the screen to the left.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--secondary-icon-activatable"></a><h3>The <code class="literal">“secondary-icon-activatable”</code> property</h3>
<pre class="programlisting">  “secondary-icon-activatable” <span class="type">gboolean</span></pre>
<p>Whether the secondary icon is activatable.</p>
<p>GTK+ emits the <a class="link" href="GtkEntry.html#GtkEntry-icon-press" title="The “icon-press” signal"><span class="type">“icon-press”</span></a> and <a class="link" href="GtkEntry.html#GtkEntry-icon-release" title="The “icon-release” signal"><span class="type">“icon-release”</span></a>
signals only on sensitive, activatable icons.</p>
<p>Sensitive, but non-activatable icons can be used for purely
informational purposes.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--secondary-icon-gicon"></a><h3>The <code class="literal">“secondary-icon-gicon”</code> property</h3>
<pre class="programlisting">  “secondary-icon-gicon”     <span class="type">GIcon</span> *</pre>
<p>The <span class="type">GIcon</span> to use for the secondary icon for the entry.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--secondary-icon-name"></a><h3>The <code class="literal">“secondary-icon-name”</code> property</h3>
<pre class="programlisting">  “secondary-icon-name”      <span class="type">char</span> *</pre>
<p>The icon name to use for the secondary icon for the entry.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--secondary-icon-pixbuf"></a><h3>The <code class="literal">“secondary-icon-pixbuf”</code> property</h3>
<pre class="programlisting">  “secondary-icon-pixbuf”    <span class="type">GdkPixbuf</span> *</pre>
<p>An pixbuf to use as the secondary icon for the entry.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--secondary-icon-sensitive"></a><h3>The <code class="literal">“secondary-icon-sensitive”</code> property</h3>
<pre class="programlisting">  “secondary-icon-sensitive” <span class="type">gboolean</span></pre>
<p>Whether the secondary icon is sensitive.</p>
<p>An insensitive icon appears grayed out. GTK+ does not emit the
<a class="link" href="GtkEntry.html#GtkEntry-icon-press" title="The “icon-press” signal"><span class="type">“icon-press”</span></a> and <a class="link" href="GtkEntry.html#GtkEntry-icon-release" title="The “icon-release” signal"><span class="type">“icon-release”</span></a> signals and
does not allow DND from insensitive icons.</p>
<p>An icon should be set insensitive if the action that would trigger
when clicked is currently not available.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--secondary-icon-stock"></a><h3>The <code class="literal">“secondary-icon-stock”</code> property</h3>
<pre class="programlisting">  “secondary-icon-stock”     <span class="type">char</span> *</pre>
<p>The stock id to use for the secondary icon for the entry.</p>
<div class="warning">
<p><code class="literal">GtkEntry:secondary-icon-stock</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkEntry.html#GtkEntry--secondary-icon-name" title="The “secondary-icon-name” property"><span class="type">“secondary-icon-name”</span></a> instead.</p>
</div>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--secondary-icon-storage-type"></a><h3>The <code class="literal">“secondary-icon-storage-type”</code> property</h3>
<pre class="programlisting">  “secondary-icon-storage-type” <a class="link" href="GtkImage.html#GtkImageType" title="enum GtkImageType"><span class="type">GtkImageType</span></a></pre>
<p>The representation which is used for the secondary icon of the entry.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read</p>
<p>Default value: GTK_IMAGE_EMPTY</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--secondary-icon-tooltip-markup"></a><h3>The <code class="literal">“secondary-icon-tooltip-markup”</code> property</h3>
<pre class="programlisting">  “secondary-icon-tooltip-markup” <span class="type">char</span> *</pre>
<p>The contents of the tooltip on the secondary icon, which is marked up
with the Pango text markup language.</p>
<p>Also see <a class="link" href="GtkEntry.html#gtk-entry-set-icon-tooltip-markup" title="gtk_entry_set_icon_tooltip_markup ()"><code class="function">gtk_entry_set_icon_tooltip_markup()</code></a>.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--secondary-icon-tooltip-text"></a><h3>The <code class="literal">“secondary-icon-tooltip-text”</code> property</h3>
<pre class="programlisting">  “secondary-icon-tooltip-text” <span class="type">char</span> *</pre>
<p>The contents of the tooltip on the secondary icon.</p>
<p>Also see <a class="link" href="GtkEntry.html#gtk-entry-set-icon-tooltip-text" title="gtk_entry_set_icon_tooltip_text ()"><code class="function">gtk_entry_set_icon_tooltip_text()</code></a>.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--selection-bound"></a><h3>The <code class="literal">“selection-bound”</code> property</h3>
<pre class="programlisting">  “selection-bound”          <span class="type">int</span></pre>
<p>The position of the opposite end of the selection from the cursor in chars.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read</p>
<p>Allowed values: [0,65535]</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--shadow-type"></a><h3>The <code class="literal">“shadow-type”</code> property</h3>
<pre class="programlisting">  “shadow-type”              <a class="link" href="gtk3-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType"><span class="type">GtkShadowType</span></a></pre>
<p>Which kind of shadow to draw around the entry when
<a class="link" href="GtkEntry.html#GtkEntry--has-frame" title="The “has-frame” property"><span class="type">“has-frame”</span></a> is set to <code class="literal">TRUE</code>.</p>
<div class="warning">
<p><code class="literal">GtkEntry:shadow-type</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
<p>Use CSS to determine the style of the border;
    the value of this style property is ignored.</p>
</div>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: GTK_SHADOW_IN</p>
<p class="since">Since: 2.12</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--show-emoji-icon"></a><h3>The <code class="literal">“show-emoji-icon”</code> property</h3>
<pre class="programlisting">  “show-emoji-icon”          <span class="type">gboolean</span></pre>
<p>Whether to show an icon for Emoji.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--tabs"></a><h3>The <code class="literal">“tabs”</code> property</h3>
<pre class="programlisting">  “tabs”                     <span class="type">PangoTabArray</span> *</pre>
<p>A list of tabstop locations to apply to the text of the entry.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--text"></a><h3>The <code class="literal">“text”</code> property</h3>
<pre class="programlisting">  “text”                     <span class="type">char</span> *</pre>
<p>The contents of the entry.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: ""</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--text-length"></a><h3>The <code class="literal">“text-length”</code> property</h3>
<pre class="programlisting">  “text-length”              <span class="type">guint</span></pre>
<p>The length of the text in the <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read</p>
<p>Allowed values: &lt;= 65535</p>
<p>Default value: 0</p>
<p class="since">Since: 2.14</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--truncate-multiline"></a><h3>The <code class="literal">“truncate-multiline”</code> property</h3>
<pre class="programlisting">  “truncate-multiline”       <span class="type">gboolean</span></pre>
<p>When <code class="literal">TRUE</code>, pasted multi-line text is truncated to the first line.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--visibility"></a><h3>The <code class="literal">“visibility”</code> property</h3>
<pre class="programlisting">  “visibility”               <span class="type">gboolean</span></pre>
<p>FALSE displays the "invisible char" instead of the actual text (password mode).</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--width-chars"></a><h3>The <code class="literal">“width-chars”</code> property</h3>
<pre class="programlisting">  “width-chars”              <span class="type">int</span></pre>
<p>Number of characters to leave space for in the entry.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Allowed values: &gt;= -1</p>
<p>Default value: -1</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--xalign"></a><h3>The <code class="literal">“xalign”</code> property</h3>
<pre class="programlisting">  “xalign”                   <span class="type">float</span></pre>
<p>The horizontal alignment, from 0 (left) to 1 (right).
Reversed for RTL layouts.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read / Write</p>
<p>Allowed values: [0,1]</p>
<p>Default value: 0</p>
<p class="since">Since: 2.4</p>
</div>
</div>
<div class="refsect1">
<a name="GtkEntry.style-property-details"></a><h2>Style Property Details</h2>
<div class="refsect2">
<a name="GtkEntry--s-icon-prelight"></a><h3>The <code class="literal">“icon-prelight”</code> style property</h3>
<pre class="programlisting">  “icon-prelight”            <span class="type">gboolean</span></pre>
<p>The prelight style property determines whether activatable
icons prelight on mouseover.</p>
<div class="warning">
<p><code class="literal">GtkEntry:icon-prelight</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
<p>Use CSS to control the appearance of prelighted icons;
    the value of this style property is ignored.</p>
</div>
<p>Owner: GtkEntry</p>
<p>Flags: Read</p>
<p>Default value: TRUE</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--s-inner-border"></a><h3>The <code class="literal">“inner-border”</code> style property</h3>
<pre class="programlisting">  “inner-border”             <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a> *</pre>
<p>Sets the text area's border between the text and the frame.</p>
<div class="warning">
<p><code class="literal">GtkEntry:inner-border</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>Use the standard border and padding CSS properties
  (through objects like <a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> and <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a>); the value
  of this style property is ignored.</p>
</div>
<p>Owner: GtkEntry</p>
<p>Flags: Read</p>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--s-invisible-char"></a><h3>The <code class="literal">“invisible-char”</code> style property</h3>
<pre class="programlisting">  “invisible-char”           <span class="type">guint</span></pre>
<p>The invisible character is used when masking entry contents (in
\"password mode\")"). When it is not explicitly set with the
<a class="link" href="GtkEntry.html#GtkEntry--invisible-char" title="The “invisible-char” property"><span class="type">“invisible-char”</span></a> property, GTK+ determines the character
to use from a list of possible candidates, depending on availability
in the current font.</p>
<p>This style property allows the theme to prepend a character
to the list of candidates.</p>
<p>Owner: GtkEntry</p>
<p>Flags: Read</p>
<p>Default value: 0</p>
<p class="since">Since: 2.18</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry--s-progress-border"></a><h3>The <code class="literal">“progress-border”</code> style property</h3>
<pre class="programlisting">  “progress-border”          <a class="link" href="GtkStyleContext.html#GtkBorder"><span class="type">GtkBorder</span></a> *</pre>
<p>The border around the progress bar in the entry.</p>
<div class="warning">
<p><code class="literal">GtkEntry:progress-border</code> has been deprecated since version 3.4 and should not be used in newly-written code.</p>
<p>Use the standard margin CSS property (through objects
  like <a class="link" href="GtkStyleContext.html" title="GtkStyleContext"><span class="type">GtkStyleContext</span></a> and <a class="link" href="GtkCssProvider.html" title="GtkCssProvider"><span class="type">GtkCssProvider</span></a>); the value of this style
  property is ignored.</p>
</div>
<p>Owner: GtkEntry</p>
<p>Flags: Read</p>
<p class="since">Since: 2.16</p>
</div>
</div>
<div class="refsect1">
<a name="GtkEntry.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2">
<a name="GtkEntry-activate"></a><h3>The <code class="literal">“activate”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry,
               <span class="type">gpointer</span>  user_data)</pre>
<p>The ::activate signal is emitted when the user hits
the Enter key.</p>
<p>While this signal is used as a
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>,
it is also commonly used by applications to intercept
activation of entries.</p>
<p>The default bindings for this signal are all forms of the Enter key.</p>
<div class="refsect3">
<a name="GtkEntry-activate.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>The entry on which the signal is emitted</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Action</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry-backspace"></a><h3>The <code class="literal">“backspace”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry,
               <span class="type">gpointer</span>  user_data)</pre>
<p>The ::backspace signal is a
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
which gets emitted when the user asks for it.</p>
<p>The default bindings for this signal are
Backspace and Shift-Backspace.</p>
<div class="refsect3">
<a name="GtkEntry-backspace.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>the object which received the signal</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Action</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry-copy-clipboard"></a><h3>The <code class="literal">“copy-clipboard”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry,
               <span class="type">gpointer</span>  user_data)</pre>
<p>The ::copy-clipboard signal is a
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
which gets emitted to copy the selection to the clipboard.</p>
<p>The default bindings for this signal are
Ctrl-c and Ctrl-Insert.</p>
<div class="refsect3">
<a name="GtkEntry-copy-clipboard.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>the object which received the signal</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Action</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry-cut-clipboard"></a><h3>The <code class="literal">“cut-clipboard”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry,
               <span class="type">gpointer</span>  user_data)</pre>
<p>The ::cut-clipboard signal is a
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
which gets emitted to cut the selection to the clipboard.</p>
<p>The default bindings for this signal are
Ctrl-x and Shift-Delete.</p>
<div class="refsect3">
<a name="GtkEntry-cut-clipboard.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>the object which received the signal</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Action</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry-delete-from-cursor"></a><h3>The <code class="literal">“delete-from-cursor”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>     *entry,
               <a class="link" href="gtk3-Standard-Enumerations.html#GtkDeleteType" title="enum GtkDeleteType"><span class="type">GtkDeleteType</span></a> type,
               <span class="type">int</span>           count,
               <span class="type">gpointer</span>      user_data)</pre>
<p>The ::delete-from-cursor signal is a
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
which gets emitted when the user initiates a text deletion.</p>
<p>If the <em class="parameter"><code>type</code></em>
 is <a class="link" href="gtk3-Standard-Enumerations.html#GTK-DELETE-CHARS:CAPS"><code class="literal">GTK_DELETE_CHARS</code></a>, GTK+ deletes the selection
if there is one, otherwise it deletes the requested number
of characters.</p>
<p>The default bindings for this signal are
Delete for deleting a character and Ctrl-Delete for
deleting a word.</p>
<div class="refsect3">
<a name="GtkEntry-delete-from-cursor.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>the object which received the signal</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>type</p></td>
<td class="parameter_description"><p>the granularity of the deletion, as a <a class="link" href="gtk3-Standard-Enumerations.html#GtkDeleteType" title="enum GtkDeleteType"><span class="type">GtkDeleteType</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>count</p></td>
<td class="parameter_description"><p>the number of <em class="parameter"><code>type</code></em>
units to delete</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Action</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry-icon-press"></a><h3>The <code class="literal">“icon-press”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>            *entry,
               <a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos,
               <span class="type">GdkEvent</span>            *event,
               <span class="type">gpointer</span>             user_data)</pre>
<p>The ::icon-press signal is emitted when an activatable icon
is clicked.</p>
<div class="refsect3">
<a name="GtkEntry-icon-press.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>The entry on which the signal is emitted</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_pos</p></td>
<td class="parameter_description"><p>The position of the clicked icon</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>event</p></td>
<td class="parameter_description"><p>the button press event</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Run Last</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry-icon-release"></a><h3>The <code class="literal">“icon-release”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>            *entry,
               <a class="link" href="GtkEntry.html#GtkEntryIconPosition" title="enum GtkEntryIconPosition"><span class="type">GtkEntryIconPosition</span></a> icon_pos,
               <span class="type">GdkEvent</span>            *event,
               <span class="type">gpointer</span>             user_data)</pre>
<p>The ::icon-release signal is emitted on the button release from a
mouse click over an activatable icon.</p>
<div class="refsect3">
<a name="GtkEntry-icon-release.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>The entry on which the signal is emitted</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_pos</p></td>
<td class="parameter_description"><p>The position of the clicked icon</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>event</p></td>
<td class="parameter_description"><p>the button release event</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Run Last</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry-insert-at-cursor"></a><h3>The <code class="literal">“insert-at-cursor”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry,
               <span class="type">char</span>     *string,
               <span class="type">gpointer</span>  user_data)</pre>
<p>The ::insert-at-cursor signal is a
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
which gets emitted when the user initiates the insertion of a
fixed string at the cursor.</p>
<p>This signal has no default bindings.</p>
<div class="refsect3">
<a name="GtkEntry-insert-at-cursor.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>the object which received the signal</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>string</p></td>
<td class="parameter_description"><p>the string to insert</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Action</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry-insert-emoji"></a><h3>The <code class="literal">“insert-emoji”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry,
               <span class="type">gpointer</span>  user_data)</pre>
<p>The ::insert-emoji signal is a
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
which gets emitted to present the Emoji chooser for the <em class="parameter"><code>entry</code></em>
.</p>
<p>The default bindings for this signal are Ctrl-. and Ctrl-;</p>
<div class="refsect3">
<a name="GtkEntry-insert-emoji.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>the object which received the signal</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Action</p>
<p class="since">Since: 3.22.27</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry-move-cursor"></a><h3>The <code class="literal">“move-cursor”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>       *entry,
               <a class="link" href="gtk3-Standard-Enumerations.html#GtkMovementStep" title="enum GtkMovementStep"><span class="type">GtkMovementStep</span></a> step,
               <span class="type">int</span>             count,
               <span class="type">gboolean</span>        extend_selection,
               <span class="type">gpointer</span>        user_data)</pre>
<p>The ::move-cursor signal is a
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
which gets emitted when the user initiates a cursor movement.
If the cursor is not visible in <em class="parameter"><code>entry</code></em>
, this signal causes
the viewport to be moved instead.</p>
<p>Applications should not connect to it, but may emit it with
<code class="function">g_signal_emit_by_name()</code> if they need to control the cursor
programmatically.</p>
<p>The default bindings for this signal come in two variants,
the variant with the Shift modifier extends the selection,
the variant without the Shift modifer does not.
There are too many key combinations to list them all here.</p>
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
<li class="listitem"><p>Arrow keys move by individual characters/lines</p></li>
<li class="listitem"><p>Ctrl-arrow key combinations move by words/paragraphs</p></li>
<li class="listitem"><p>Home/End keys move to the ends of the buffer</p></li>
</ul></div>
<div class="refsect3">
<a name="GtkEntry-move-cursor.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>the object which received the signal</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>step</p></td>
<td class="parameter_description"><p>the granularity of the move, as a <a class="link" href="gtk3-Standard-Enumerations.html#GtkMovementStep" title="enum GtkMovementStep"><span class="type">GtkMovementStep</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>count</p></td>
<td class="parameter_description"><p>the number of <em class="parameter"><code>step</code></em>
units to move</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>extend_selection</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> if the move should extend the selection</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Action</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry-paste-clipboard"></a><h3>The <code class="literal">“paste-clipboard”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry,
               <span class="type">gpointer</span>  user_data)</pre>
<p>The ::paste-clipboard signal is a
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
which gets emitted to paste the contents of the clipboard
into the text view.</p>
<p>The default bindings for this signal are
Ctrl-v and Shift-Insert.</p>
<div class="refsect3">
<a name="GtkEntry-paste-clipboard.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>the object which received the signal</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Action</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry-populate-popup"></a><h3>The <code class="literal">“populate-popup”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>  *entry,
               <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget,
               <span class="type">gpointer</span>   user_data)</pre>
<p>The ::populate-popup signal gets emitted before showing the
context menu of the entry.</p>
<p>If you need to add items to the context menu, connect
to this signal and append your items to the <em class="parameter"><code>widget</code></em>
, which
will be a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> in this case.</p>
<p>If <a class="link" href="GtkEntry.html#GtkEntry--populate-all" title="The “populate-all” property"><span class="type">“populate-all”</span></a> is <code class="literal">TRUE</code>, this signal will
also be emitted to populate touch popups. In this case,
<em class="parameter"><code>widget</code></em>
 will be a different container, e.g. a <a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.
The signal handler should not make assumptions about the
type of <em class="parameter"><code>widget</code></em>
.</p>
<div class="refsect3">
<a name="GtkEntry-populate-popup.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>The entry on which the signal is emitted</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>widget</p></td>
<td class="parameter_description"><p>the container that is being populated</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Run Last</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry-preedit-changed"></a><h3>The <code class="literal">“preedit-changed”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry,
               <span class="type">char</span>     *preedit,
               <span class="type">gpointer</span>  user_data)</pre>
<p>If an input method is used, the typed text will not immediately
be committed to the buffer. So if you are interested in the text,
connect to this signal.</p>
<div class="refsect3">
<a name="GtkEntry-preedit-changed.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>the object which received the signal</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>preedit</p></td>
<td class="parameter_description"><p>the current preedit string</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Action</p>
<p class="since">Since: 2.20</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkEntry-toggle-overwrite"></a><h3>The <code class="literal">“toggle-overwrite”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> *entry,
               <span class="type">gpointer</span>  user_data)</pre>
<p>The ::toggle-overwrite signal is a
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
which gets emitted to toggle the overwrite mode of the entry.</p>
<p>The default bindings for this signal is Insert.</p>
<div class="refsect3">
<a name="GtkEntry-toggle-overwrite.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>entry</p></td>
<td class="parameter_description"><p>the object which received the signal</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: Action</p>
</div>
</div>
<div class="refsect1">
<a name="GtkEntry.see-also"></a><h2>See Also</h2>
<p><a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a>, <a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion"><span class="type">GtkEntryCompletion</span></a></p>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.33.1</div>
</body>
</html>